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ABSTRACT 


The  design,  devel ocnent  and  iTolementation  of  a  user- 
orientea  graohics  software  system  is  descrioea.  The  over-all 
considerations  involved  in  such  a  design  orocess  are  dis- 
cussed/ along  with  the  major  factors  affecting  design  Deci- 
sions. The  object  disclay  system  is  a  R A M J E K  GX-10  0A  hosted 
Oy  a  PDP-11/50  comouter.  I^olementation  techniaues  are  also 
Dresenteo.  A  detailed  user's  manual  is  aooenaed*  ana  recom- 
menaations  for  further  svste^  exoansion  are    offered. 


CONTENTS 


I.  INTRODUCTION 6 

II.  DESIGN  CONSIDERATIONS 8 

III.  LANGUAGE  SELECTION 14 

IV.  DESIGN  OF  SYSTEM  FUNCTIONS 20 

V.  DOCUMENTATION 26 

VI.  IMPLEMENTATION  AND  TESTING 3  1 

A.   PREFERRED  TECHNIQUE 31 

8.   MODIFIED  TECHNIQUE 32 

1  .   V  A  L  I D  A  T  I  0  f  /  C  0  N  D  E  w  N  A  j  I  0  N 3  2 

2.  IMPLEMENTATION 3a 

3.  DETAILED  TESTING 3  a 

a.   CONTINUED  TESTING 35 

VII  .   RECOMMENDATIONS 3o 

VIII  .   CONCLUSIONS 38 

IX.   APPENDIX  A 39 

X  .   A  p  p  E  N  D  I  x  6 I  a  a 

XI.  BIBLIOGRAPHY 2nu 

XII.  INITIAL  DISTRIBUTION  LIST 211 


I.   INTRODUCTION 


Design  techniques  for  user-oriented  graohics  software 
systems  are  investicateo.  The  orincicles  and  techniques 
gained  from  this  research  have  o  e  e  n  aoolied  in  the  implemen- 
tation of  such  a  system  for  a  R A M T E K  GX-luOA  oisolay  device. 

Primary  e  m  o  h  a  s  i  s  is  olaced  on  oroviaing  a  user  with  the 
proDerly  constructed  software  suooort  and  accompanying  aocu- 
mentation  for  efficient  utilization  of  the  grachics  display 
system.  The  techniaues  and  decisions  involved  in  oerforming 
such  a  aesign  are    discussed  in  detail. 

Additionally*  the  vector  General  Tanlet  was  interfaced 
with  the  supDort  system.  This  interface  provided  the  user 
with  an  external  interactive  device  for  control  of  the 
graphics  system.  The  ability  to  interact  with  the  system 
greatly  enhanced  the  oesiranility  of  the  over-all  desion. 


The  basic  sfeos  in  the  aoclication  phase  were  to  choose 
a  1  a  n  a  u  a  g  e  *  desion  systems  functions*  write  a  detailed 
user's  manual >  and  i  m  c  1  e  ^  e  n  t  ana  test  the  system.  The  user's 
manual  (Acnenci*  A)  nrovides  even  the  i ne xce r i enc ed  program- 
mer with  a  tool  for  rapid  access  to  the  system.  It  is  c  o  m  - 
olemented  with  a  tutorial  set"  of  examples  that  more  accom- 
plished users  miaht  proceed  to  immediately. 


The  designee!  system  was  implemented  in  the  C  orcgram- 
ming  language  and  hosted  by  a  POP-11/50  comcuter  in  the 
Naval  Postgraduate  School  Computer  Lacoratory. 


II.   DESIGN  CONSIDERATIONS 


The  following  is  a  quote  from  Dr.  Eric  Carlson  of  the 
IBM  Research  Division  [14]: 

"In  the  oast/  orogress  in  terminal  hardware  technology 
and  craohics  software  techniques  has  not  been  accom- 
panied by  similar  oroaress  in  unaerstanqing  the 
requirements  of  the  user  and  aoplications  of  comouter 
graphics". 
The  desian  effort*  therefore/  in  computer  Graphics  must  be 
applied  to  provide  clarity  in  m an/machine  communication. 

The  evolutionary  orocess  of  a  user-oriented  svstem  must 
begin  w i t h  a  firm  definition  of  the  user.  In  this  context  a 
user  is  defined  to  te  some  person  or  group  of  persons  who 
desire  to  utilize  some  graohics  system.  He r  for  the  most 
part*  is  a  non-comouter  scientist  who  simply  wishes  to  be 
assisted  Cy  the  computer  in  the  solution  of  some  prorlem.  If 
he  must  exoenq  a  qre^t  deal  of  effort  to  learn  how  to  use 
the  system  oefore  any  benefits  can  be  accrued,  then  the  sys- 
tem appears  not  to  o  e  a  tool  out  just,  another  hurdle. 


Any  comouter  system  has  the  ultimate  curoose  of  solving 
a  problem  or  set  of  croolems.  in  hen  a  user  elects  to  utilize 
the  oower  of  a  comouter  system  to  solve  a  oroblem,  then  un<- 
nowingly   he  or  she  has  added  the  requirement  tnat  the  orob- 


lem  be  stated  in  two  very  distinct  ways.  The  problem  must  on 
one  hand  take  on  a  structure  that  is  amenable  to  the  com- 
puter* and  on  the  other  hand  be  stated  clearly  and  concisely 
to  man.  As  the  user's  statement  of  the  problem  is  decomoosea 
to  a  machine-oriented  statement  of  the  same  Droblem*  the 
interface  between  the  user  and  the  system  is  critical.  The 
ideal  interface  Droviaes  a  conservations!  communication  or 
"symbiosis"  between  man  and  machine*. 

The  user  ™  u  s  t  c  e  nrovioeo  as  many  aids  as  ohysically 
possible  to  create  an  atmosohere  that  is  conducive  to 
creative  thought.  If  he  expends  the  majority  of  his  effort 
attempting  to  communicate*  he  is  not  likely  to  be  very 
creative.  Thus  the  man-machine  communication  must  be 
enhanced  in  every  conceivaole  manner. 


The  design  effort  must*  necessarily,  begin  with  con- 
siderations of  available  eauioment.  If  the  eauioment  is 
alreaav  in  d  o  s  i  t  i  o  n  ,  as  it  was  in  this  endeavor*  the 
designer  should  strive  to  interface  acorooriafe  interactive 
tools  for  a  oleasant  communication  sc^e^e.  These  devices* 
though  auite  varied*  "can  be  treated  as  a  physical  realiza- 
tion of  one  of  four  virtual  devices  :  the  oick,  the  button, 
the  locator,  ana  the  valuator"  1121.  The  four  virtual  dev- 
ices are    define d  below: 

A  .  A  oic<  is  used  to  designate  certain  objects*  The  user 
will  often  neec  to  ooint  at  objects*  just  as  a  person 
may  ooint  his  f  i  ^  a  e  r  to  denote  a  particular   ol ace   or 


t  h  i  nq  . 
6  .  A  button  is   for   oroarammatic   control    -  -   Such   as 

select  inq   a   particular   action  from  several  possible 

actions,  (commonly  a  function  kevboaro) 
C  .  A  locator  allows  the  user  to  locate   soecific   points 

within   his   defined   image  space,  (commonly  a  tablet/ 

joystick,  or  mouse) 
D.  A  valuator  provides  the   caoabilitv   to   aetermine   a 

particular  value  from  some  defined  real  space. 

Thus  in  desiqnmq  a  user-orientea  system,  certain 
hardware  selections/interface  decisions  must  n  e  performed 
prior  to  embarkinq  on  the  software  suooort  design. 

The  design  of  a  user-oriented  graDhics  software  system 
must  provide  the  full  capability  of  the  nraphics  device, 
satisfy  the  user,  and  net  overload  the  host  computer.  To 
achieve  these  acals,  a  top  down  approach  seems  most 
appropriate  while  maintaining  a  constant  focus  on  user 
requirements.  To  realize  a  successful  design  of  a  graphics 
software  system  the  designer  must  choose  a  suitaole  imple- 
mentation lanouage,  crovi.ie  adeouate  software  support  func- 
tions, develop  detailed  documentation,  and  finally  implement 
tne  lesion  ?nd  oerform  detailed  testing  of  the  package. 

The  authorities  en  computer  grapnics  tooay  see  two 
feasible  choices  for  oraphic  language  selection.  A  graphics 
language  may  oe  developed  for  the  specific  device  or  an 
existing   hioh-level   1  a  n  q  u  a  a  e  ,  supplemented  by  a  library  of 
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subroutines,  may  be  employed. 

The  designer  who  elects  to  provide  a  soecial  Purpose  , 
device  dependent  lanouaqe  is  nomal  lv  directing  his  atten- 
tions to  a  subset  of  the  entire  user  population.  Such  a 
1 anguaae  will  often  emolov  peculiar  constructs  while  striv- 
ing for  increased  effiency.  In  orevious  studies  it  has  been 
found  that  the  design  ano  implementation  of  a  special  pur- 
pose graohics  lancuaae  often  provides  more  of  a  learning 
experience  to  the  desioner  than  a  useful  tool  to  the  user. 
In  addition,  the  development  of  such  a  language  invariably 
reauires  a  great  deal  of  expertise  in  1 anduage  structures 
and  often  snowballs  into  a  costly  and  time  consuming 
enoeavo  r . 

The  most  common  approach  to  utilizing  graphics  e  a  u  i  o  - 
ment  is  to  build  around  an  existing  language  and  generate 
CALLS  to  a  set  of  subroutines  resident  in  some  library.  The 
host  1 anguaae  must  provide  the  necessary  facilities  ,  sup- 
port the  aoorocriate  oata  structures,  and  possess  an  effi- 
cient subroutine  call  caoaoility.  If  sucn  a  1 anguaae  exists 
in  the  design  environment,  stronq  consideration  should  be 
given  to  employ i no  it  as  the  base  lanouaqe  for  the  graphics 
system. 

Having  considerec  all  notions  and  selected  a  base 
language  uoon  which  to  build  the  oraphics  system  the  focal 
point  of  the  design  process  most  oe  shifted  to  the  logical 
formulation  of  the  graphical  primitives  reauired  by  the  user 
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population.  William  ^ .  'Newman  and  Robert  F.  Sproull  [10] 
profess  that  "the  only  araphical  primitives  that  the  pro- 
grammer needs  are  functions  to  define  points?  lines  and 
display  text  strings".  These  c  a  s  i  c  primitives  certainly  p ro- 
vide  the  most  funaamental  set  of  tools?  but  by  offering 
selected  ootions  to  the  user  a  less  hostile  and  more  flexi- 
ble system  may  evolve. 

The  founaation,  havino  been  envisioned  and  looically 
designed?  should?  when  o  1  a  u  s  i  p  1  e  ?  he  expanded  to  provide  the 
user  with  a  oowerful  set  of  hioh-level  tools.  The  direction 
of  this  expansion  is  necessarily  precipitated  bv  the  ouroose 
for  the  aracnics  system.  This  nrocess  may  provide  a  very 
precise  set  of  functions  in  the  design  of  special  ouroose 
systems/  or  a  number  of  task  oriented  functions  which 
emphasize  overall  system  Generality.  Each  new  function 
spawned  by  this  exoansion  must  orovide  the  user  with  a  new 
and  oowerful?  vet  si^cle?  tool. 

Documentation  must  parallel  the  entire  design  crocess. 
A  vital  1 v  important  cart  of  this  documentation  effort  is  the 
creation  of  a  detailed  user's  manual.  This  user's  manual 
should  be  virtually  complete  crior  to  the  implementation  and 
testing  phase.  The  designers  have  thus  stated  how  the  ulti- 
mate system  is  envisioned. 

Havina  reached  this  plateau?  the  implementation  and 
testing  erase  o  e  g  i  n  s  >  out  the  documentation  effort  must  con- 
tinue  in   parallel.   In       the   end?   the   complete   set    of 
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documentation  efforts  -nust  include  a  detailed  user's  manual, 
documented  source  code,  synopses  of  functions,  and  a  trace 
of  the  entire  process. 

The  implementation  and  testing  phase  oeains  with  the 
creation  of  the  actual  software  to  perform  the  oroposed 
actions.  As  this  software  comes  into  ceing,  detailed  testing 
must  oe  oerformed  to  ensure  that  it  functions  as  envisioned. 

In  summary/  the  designers  must  follow  some  p  r  p  - 
established  plan  for  the  development  of  a  graphics  software 
system.  In  the  absence  of  such  a  o 1  a n ,  it  is  almost  inevit- 
able that  the  resulting  system  will  fall  snort  of  its  exoec- 
tations. 
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III.   LANGUAGE  SELECTION 


As  previously  stated  tnere  are  two  plausible  choices  in 
selecting  the  1 anauace  to  support  a  user-oriented  graphics 
system.  This  choice  is  driven  by  the  ultimate  purpose  of  the 
system/  time/  and  money.  Tne  system  Designers  may  develop  a 
new  languaae  tailored  exclusively  fop  the  device/  or  utilize 
an  existing  h i qh  level  lanouage  augmented  cv  a  library  of 
functions  for  control  of  the  device.  Kegaroless  of  t  f  e 
course  of  action  the  "elect  ion  should  "crovioe  a  languaae 
which  is  natural/  and  which  does  not  acid  to  the  boredom, 
panic*  frustration/  and  confusion  of  the  user"  1121  . 

The  environment  for  t^e  design  effort  associated  with 
this  work  was  for  the  most  oart  academic  and  reouired  great 
flexibility  and  Generality  for  t^e  widely  varied  user  pecu- 
lation. The  users  of  the  projected  svstem  would  come  from 
all  bac<arounas  and  with  an  infinite  set  of  reauirements  for 
the  svstem.  D,u e  to  this  need  for  extreme  flexibility  a 
search  began  to  find  a  suitable  high  level  lanouage  to  meet 
the  reauirements. 

The  possibility  of  constructing  3  uniaue  languaae  to 
support  the  system  was  ruled  out  a  1  m  o  s  t  immediately  due  to 
the  time  constraint  of  the  effort.  Lack  of  time  was  cer- 
tainly  a   valid   reason   in   itself/  but  other  factors  also 
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deemed  this  course  of  action  unfeasible.  The  goal  was  flexi- 
bility/ and  almost  always  a  new  lanauaqe  Decodes  directed 
to  a  subset  of  the  user  oooulation.  Tr\e  developed  system 
would  require  on  station  software  maintenance  and  would 
receive  little  or  no  attention  if  it  existed  as  a  new  and 
foreign  languaae. 

Havina  made  the  basic  choice  to  utilize  an  existing 
high  level  languaae  the  search  began  for  an  acceptaole  one. 
The  Naval  Postgraduate  School  Comouter  Laboratory  hosts  the 
eouioment  an-i  as  sue**  its  caoanilities  ana  restrictions  were 
considered  in  detail.  Tnere  were  several  lanauaaes  commonly 
in  use  *  i  t  n  i  n  tie  confines  of  the  laboratory  (C  ,  Fortran, 
Basic). The  most  wilely  use a  of  all  the  languages  was  C  [3] 
and  as  such  research  was  initiated  to  ascertain  the  feasi- 
bility of  this  choice  for  the  orooosea  system. 

The  C  oroaramming  languace  was  well  documented  and 
allowed  the  user  to  write  clear  and  concise  orograms.  It  had 
nice  control  caoaoilities  Tia<ina  it  a  very  readable 
languaae,  ann  it  allowed  the  user  to  write  code  that  is  very 
compact  out  still  clear.  Ine  lanauage  encouraged  a  modular 
design  ana  o  r  o  v  i  a  e  d  all  of  the  necessary  constructs  to 
implement  a  viaole  graphics  system.  The  fact  that  the 
language  was  commonly  used  bv  oersonnel  involved  in  research 
within  the  confines  of  the  laboratory  was  another  plus  for 
selectina  it  for  this  aoplication.  J  he  feel  ina  *  a  s  that  the 
C  programming  lanauage   would  suooort  a  comoletely   flexible 
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and  general  o  u  r  o  o  s  e  o  r  a  o  n  i  c  s  svste^J  thus   the   decision   to 
i  m  o  1  e  m  e  n  t   the   system   with   it   as   the   base   programming 

languaoe  was  made. 

A  software  supoort  oackaqe  existed  for  the  R A M T E K  [18] 
at  the  onset  of  this  research  effort/  Out  its  configuration 
was  unacceptable  oasec  on  the  research  to  this  point.  From 
previous  studies  it  was  learned  that  a  high  level  lanquage 
supported  bv  a  library  of  functions  was  the  most  common 
apcroach  to  utilizing  a  araohics  device.  The  existing 
software  support  o  a  c  k  a  a  e  did  not  resemble  this  basic  design 
philosophy,  3s  it  existed  as  two  very  large  blocks  of  coject 
code,  ^eaardless  of  the  size  or  needs  cf  the  user  program 
these  two  blocks  of  cole  were  merely  appended  to  the  com- 
piled program  resulting  in  a  very  large  execution  module. 
This  implementation  techniaue  was  found  to  be  completely 
unsatisfactory  from  a  design  standpoint. 

tiavino  decided  to  use  the  C  programming  language  and 
real  izino  r  h  a  >*  the  existing  software  support's  organization 
was  not  in  compliance  with  the  prescribed  goals/  the  next 
step  was  to  d eveloo  the  structure  and  organization  of  a  set 
of  library  support  functions  to  oroviae  for  scecific  supoort 
of  the  device.  A  aetailea  analysis  of  the  existing  system 
was  initiated.  The  system  was  f  o  u  n  n  to  crovide  the  basic 
caDabilities  and  m ocular  desion  that  was  felt  would  be 
reguireo.  The  decision  was  made  to  base  the  new  supoort  sys- 
tem on  the  C  programming  language  plus  a  library  of  rudimen- 
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tary  functions  sec  urea  from  the   previous   software   suooort 
system. 

Prior  to  embarking  on  the  task  of  b  u  i  1  d  i  n  q  such  a 
library?  the  UNIX  ooerating  system  constraints  were  invesi- 
gated  to  reveal  the  orooer  library  structure.  This  environ- 
mentally imoosed  structure  was  a  major  concern  as  the 
development  orccess  Cegan.  T^e  reason  t  n  a  t  no  orevious 
attempts  had  oeen  male  to  provide  the  envisioned  structure 
was  that  it  was  to  oe  quite  tedious  and  oossibly  reauire  a 
great  deal  of  redesign.  In  the  Ui\lX  environment  the  library 
is  searched  seauentially  from  start  to  finish  to  resolve  any- 
undefined  references  from  the  compilation  of  a  user  program. 

This  linear  search  procedure  employed  by  the  host  sys- 
tem dictates  that  the  Horary  have  a  very  precise  structure 
if  it  is  to  oe  efficient.  As  the  library  searcn  is  performed 
all  references  Ov  internal  functions  mus1"  be  forward  to  cir- 
cumvent the  necessity  of  multiple  searches  of  the  same 
library.  Failure  to  oroanize  the  library  around  this  very 
real  constraint  coulo  result  in  very  inefficient  utiliza- 
tion. To  organize  the  rudimentary  library  in  such  a  way 
required  i  n  d  e  p  t  h  study  of  the  existing  software. 

The  existing  software  suooort  cac(<aoe  was  studied  in 
detail  to  determine*  without  exception,  the  precise  func- 
tioninq  of  each  nodule.  It  was  paramount  to  explicitly  learn 
the  path  of  function  calls  from  each  of  the  existino  pro- 
cedural functions.  This  information  was   found   to   he   best 
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depicted  in  tabular  format. 

A  table  of  cross-references  for  each  function  was  con- 
structed. This  table  ultimately  displayed  the  calling 
sequence  for  each  function  and  what  functions  called  it. 
This  organizational  steo  orovided  the  insight  required  to 
beoin  to  organize  the  library.  Had  the  original  design 
employed  a  library  in  the  language  decision  orocess  vice  two 
large  "programs"  this  steo  could  have  been  eliminated  from 
this  design.  The  fact  that  the  new  user-oriented  desicn  will 
be  in  a  library  will  facilitate  more  efficient  software 
maintenance  and  significantly  reduce  the  size  of  the  user's 
execution  mobule. 

The  existino  o  a  c  *  a  g  e  was  written  in  the  C  programming 
language  anc,  as  such,  fitted  the  oropcsed  language  imple- 
mentation techniaue  cuite  well.  The  structure  having  been 
exposed,  the  task  was  to  build  a  fundamental  support  library 
from  oreviously  oevelcoed  software.  The  functions  were 
further  researcneo  to  see*  out  whicn  variacles  were  used  by 
each  function.  This  process  was  most  involved,  but  neces- 
sary, as  the  environment  of  UNIX  allowed  for  only  singular 
initialization  of  each  variable. 

An  o roan i za t i ona 1  chart  was  developed  to  ascertain 
where  ana  when  initialization  of  e  a  c  n  variaole  was  to  take 
place.  Once  the  variacles  had  been  laid  out  in  a  logical 
initialization  seauence*  the  actual  buildina  crocess  could 
be  embarked  upon.  The  conceptual  design  could  be  seen   as   a 
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feasible  tas*/  but  an  explicit  layout  of  the  proposed 
library  had  to  be  made  ana  manually  verified.  The  Structure* 
to  be  efficient/  had  to  oossess  no  backward  references  and 
provide  for  singular  initialization  of  all  variables. 

The  base  library  was  desianed  and  i  m  c  1  e  m  e  n  t  e  d  .  After 
detailed  testing  it  became  apparent  that  the  new  concept 
performed  better  than  the  old  even  though  there  were  no  phy- 
sical improvements  to  the  software  ^unctions  themselves.  The 
library  provided  much  smaller  execution  modules/  as  only  the 
user-requested  functions  were  appended/  not  the  entire  d  a  c  <  - 
age  as  was  previous! v  the  case.  This  newly  structured 
library  also  oossessed  the  benefit  of  ease  of  maintenance 
and  expansion.  This  represented  a  ^  a  j  o  r  steo  in  the  overall 
goal  of  the  project. 


The  first  steo  in  the  design  of  a  user-oriented  araph- 
ics  system  had  been  accomplished.  An  existing  language  sup- 
ported cv  a  Horary  of  subroutines  had  been  chosen  for 
i mo  1 emen t a t i on  of  the  system.  Had  this  step  been  performed 
in  the  original  investigation  a  more  viable  and  maintainable 
system  would  have  existed  from  which  to  aecart.  It  was  felt 
that  this  structure  orovided  maximum  flexibility?  efficiency 
and  created  a  firm  case  from  whic^n  to  proceed  toward  a 
user-oriented  system. 


IV.   OESIGM  OF  SYSTEM  FUNCTIONS 


The  trend  in  the  levelooment  of  graphics  software  sys- 
tems is  toward  hich-l°vel  software  support  oackaaes  that 
provide  s  i  m  o  1  e  ,  powerful  controls  over  the  cacaoi  1  i  t  i  es  of 
the  system,  yet  shelter  the  oroarammer  from  the  low-level 
features  of  the  hardware.  The  desian  of  the  functions  that 
make  up  these  software  cac'<aaes  o  1  a  y  s  a  vital  cart  in  deter- 
mining the  success  or  failure  of  the  svstem  as  a  whole. 

In  the  environment  discussed  here,  the  basic  machine- 
level  interface  C  t  h e  "driver")  oetween  the  host  computer  and 
the  graphics  disci  ay  cevice  had  oeen  installed.  In  addition, 
a  '  number  of  software  routines  had  oeen  written  for  the  sys- 
tem. There  was  no  organized  library  of  system  functions. 
Instead,  all  of  the  written  routines  hao  been  conglomerated 
into  two  files,  including  a  very  larce  sample  program.  Tne 
requirement  to  crinc  cot f  of  these  1 aroe  files  into  memory 
for  every  program's  execution  was  consiaerpa  unacceptable  by 
established  desian  stanaaros. 

It  was  decided  at  this  roint  that  the  most  realistic 
approach  would  oe  to  modularize  t'ne  existing  functions, 
oraanize  t  n  e  m  into  a  properly  formatted  library  structure, 
and  thoroughly  analyze  this  packaae  for  content  and  func- 
tional capability.  The  desian  and  de ve 1 ocmen t  of  this  system 
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library  was  discussed  in  "LANGUAGE  SELECTION". 

The  ensuing  analysis  of  exist  inq  routines  revealed  many 
shortcomings  that  reouired  either  modifications  to  the 
existing  code  or  a  ccfrolete  redesign  of  that  oarticular 
function.  In  addition,  the  software  package  as  a  whole  did 
not  offer  the  user  the  full  capabilities  of  the  system  as 
envisioned  by  the  oesianers.  As  well  as  not  providing  the 
full  capability  of  the  o  e  v  1  c  e  ,  the  system  was  severely  lack- 
ing in  interactive  tools.  The  system  did  not  provide  suffi- 
cient control  and  communication  facilities  for  the  user. 
Numerous  additional  functions  were  designed/  created,  anc 
implemented  for  this  curoose. 

This  oriase  of  the  lesion  process  was  not  a  ourelv 
creative  exercise.  It  */as  a  case  of  the  designers  overlayino 
the  existing  software  with  e  "template"  or  ".mold"  of  the 
system  they  envisioned;  tnen  modifying,  restructuring,  and 
expandino  the  existing  pac^aoe  to  fit  this  mold.  Tne  system 
functions  that  evolved  from  this  "modified"  desian  process 
are    presented  in  detail  in  the  user's  M  a  n  u  a  1  (^Dcendix  A). 

The  inclusion  of  an  increased  interactive  capability 
involved  the  logical  design  and  creation  of  avenues  to 
facilitate  a  more  symbiotic  man-machine  communication  sys- 
tem. The  only  external  device  a  v  a  i  1  a  o  1  e  to  the  user  was  the 
keyooard.  A  basic  Graphics  system  can  survive  with  only  this 
caoability,  Put  shoulc  not  op  restricted  to  this  device  wren 
the  oossibility  for  exoansion   exists.   A   concerted   effort 
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then  began  to  provide  the  user  with  a  flexible  communication 
medium.  This  medium  was  the  Vector  General  Data  Tablet. 

In  developing  this  interactive  tool  to  its  fullest*  the 
intent  was  to  aive  this  one  physical  device  the  capability 
to  apoear  as  four  virtual  devices  (Dick*  outton*  locator* 
valuator).  Tne  oick  ana  locator  functions  could  o  e  satisfied 
via  a  tablet  driven  cursor.  This  capabilitv  became  one  of 
the  ooals  of  the  software  lesion.  The  tablet  could  also  ful- 
fill the  valuator  function  orovided  it  could  take  on  vari- 
able dimensions*  anc  dive  the  user  the  ability  to  select 
values  from  within  this  soace.  Finally*  the  tablet  cculo  be 
broken  into  user-defined  switches  that  could  resoono  as  but- 
tons or*  function  switches  for  crogrammatic  control. 

6y  logically  envisionino  f  h  e  tablet  as  discussed  above* 
it  provided  a  nice  co^dI e^ent  to  the  R A M T E K  keyboard.  The 
user*  now  having  two  interactive  devices  at  his  disposal* 
would  enjoy  a  more  flexiole  communication  interface  with  tne 
machine. 

A  cross-sectional  view  of  tne  software  suoport  oackace 
would  reveal  a  structure  of  "tiered  co^olexity".  At  the  base 
of  this  structure  would  lie  the  oasic  crin-itives  for  a 
graphics  system's  operation.  Some  of  these  routines  are  only 
one  step  removed  f ror  machine  1  a  n  g  u  a  a  e  instructions.  These 
primitives  form  the  tounaation  for  higher  level  function 
develooment*  but  must  also  be  ^aoe  accessible  to  the  more 
advanced   users'   orocrarrs.   The  n»xt  level  in  the  structure 
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would  oe  comorised  o  *  mnre  definitive  Graphics  aoDl  ications 
functions.  vost  users  could  accomplish  all  their  desired 
work  at  this  software  level/  but  it  would  likelv  require 
numerous  and  reoetitive  cells  to  these  functions.  The 
high-level  functions  that  form  the  crest  of  this  structure 
are  directly  suDoorted  ov  the  first  two  levels.  These  are 
the  functions  that  offer  the  user  more  powerful/  problem- 
oriented  ootions. 

This  asoect  of  three  levels  of  araduateo  potential  was 
applied  to  each  of  the  functional  areas  or  control  modes  of 
the  RAMTEK  ourina  this  r:esi  an/evaluation  phase.  This  was 
also  the  anoroach  useo  to  ensure  that  tne  full  range  of 
color  manipulation  capabilities  we r e  availaole  to  the  user. 
Thus  as  each  basic  hardware  cacability  was  investigated/  the 
associated  software  fc  exoloit  that  caoability  was  logically 
designed  and  conceotuallv  aligned  with  this  structure.  If 
the  existing  software  d  i  a  not-  conform  to  this  view  or  did 
not  function  to  the  envisioned  soec i f i c a t i on s  for  that  oar- 
ticular  machine  caoabilityr  it  was  modified  and/or  expanded 
to  do  so . 

Most  of  the  modifications  that  were  required  were  to 
functions  of  tne  first  and  second  levels.  For  instance/  tne 
procedure  for  select  i  nc  a  particular  color  entry  (from  the 
current  color  table)  was  ooorlv  i^olemented.  This  function 
had  to  ne  completely  redesigned  to  achieve  tne  proper 
results.   Likewise/  the  routine  that  existed  for  tne  ourpose 
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of  establ  i  shina  a  starting  Dcint  for  generating  any  display 
haa  not  taken  into  account  certain  control  mode/control  flag 
combinations  that  require  more  than  one  machine-level 
instruction  to  initialize  the  proper  registers.  Minor 
corrections  or  imorovements  were  maae  to  numerous  other 
functions  in  the  first  t  *  o  strata  of  the  design  structure, 
primarily  in  the  areas  of  mapping  virtual  screen  addresses 
to  real  screen  locations/  and  performing  error  checks. 

The  majority  of  ne*  functions  that  vvere  cesigneci  and 
created  aurina  this  process  were  hian-level  functions  aimed 
at  improving  over-all  system  performance.  During  the  evalua- 
tion of  the  color  di splav  techniaues#  it  was  recognized  that 
a  user  could  snend  a  creat  deal  of  time  in  generating  t  n  e 
exact  colors  he  3  e  s  i  r  e  a  for  a  oarticular  a i splay?  vet  he  had 
no  way  of  saving  these  color  combinations  for  subseauent 
use,  since  the  svstem  color  tables  ere  automatically  ini- 
tialized upon  each  new  acc°ss  to  the  device.  This  forced  the 
user  to  regenerate  his  colors  at  each  session  on  the  ecuip- 
ment  --  a  time  consuming  task.  This  caoanility  of  oreserving 
user-oefined  colors  between  intermittent  sessions  *  a  s  viewed 
as  an  absolute  necessity.  Thus  two  new  functions  were 
developed  :  one  to  cooy  the  status  of  current  color  taoles 
into  a  file  in  the  user's  directory,  ana  one  to  subsequent  1 v 
restore  these  colors  n  a  c  *  into  the  system  taoles  after  ini- 
tialization has  taxen  ol ace. 


2a 


Another  capability  that  was  found  lacking,  and  was 
therefore  generated  during  this  chase*  was  the  ability  to 
simultaneously  display  multiple  alphanumeric  character 
strings*  such  as  blocks  of  text.  This  function  relieves  the 
user  of  the  distracting  task  of  making  repeated  calls  to  the 
mid-level  single  strino  ii  sdI av  function. 

by  application  area*  the  largest  number  of  newly- 
introduced  facilities  were  in  the  real"1  of  Providing  an 
interactive  capability  between  the  R  A  K>  T  E  K  display  system  and 
a  Vector  General  Tablet.  Ado r o x i t a t e 1 v  fifteen  functions 
were  designed  in  the  afore-mentioned  tiered  structure  to 
offer  the  user  a  »iae  variety  of  interactive  techniaues. 
The  tablet  may  thus  be  used  for  manioulatina  or  Generating 
color  tables*  directing  the  movement  of  a  software-generated 
cursor  on  the  display  screen?  selecting  proora^  execution 
options  from  a  menu  of  loaical  taclet  switches*  or*  with 
prooer  application  of  lower-level  functions*  "sketching"  a 
display  onto  the  screen. 

The  modified  design  approach  that  was  taken,  in  con- 
junction with  the  tiered-srructure  view  of  the  software* 
proved  highly  efficient  by  preventing  the  loss  or  waste  of 
any  previously  nevelooen  functions*  while  readily  identify- 
ing any  lack  of  functional  capability  in  a  carticular  area. 

The  envisioned  system  ana  the  newly  introduced  capabil- 
ities* in  order  to  provide  a  truly  user-oriented  environ- 
ment* reguireo  a  continuous  reflection  on  the  user   and   his 
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psychological  o  e  h  a  v  i  o  r  .  The  user's  basic  psychological 
requirements  are  time  dependent  1171 .  The  user  expects  cer- 
tain responses  in  a  scecific  time  frame  or  he  becomes  frus- 
trated and  disDl easel  with  the  system.  Each  scecific  func- 
tion was  evaluatea  for  oossiole  unfavorable  psycnological 
responses . 

The  psychological  make-uo  of  the  user  was  of  pri^e 
importance  in  the  actual  aesiqn  of  the  interactive  color 
manipulation  routine  tabcolorO.  T^is  function  allows  the 
user  to  interactively  modify  and/or  create  system  color 
tables.  The  excectations  ana  oossible  frustrations  of  the 
user  were  researcnea  in  detail  in  this  regard. 

Thus  the  user  was  recognized  to  nave  certain  expecta- 
tions [17  3;  ana  a  concerted  effort  was  maae  to  ensure  that 
the  system  coulfl  adequately  meet  these  excectations.  The 
competing  properties  of  efficiency  ana  simclicitv  remained 
fundamental  considerations  throughout  the  develcomental  pro- 
cess. 

when  Possible?  the  system  functions  were  designed  to 
emDloy  "interaction  by  anticipation"  1151.  This  aoproacn 
decreased  the  r  e  a  u  i  r  «  c  number  o  *  aiagnostic  messaaes  and 
should  result  in  a  Tore  satisfied  user. 

Satisfactory  response  times  w°re  also  considered  in  the 
over-all  system  design.  It  was  found  that  users  could  become 
frustrated  a  no    annoyed  by  the  imnrooer  timing  of   responses. 
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For  example/  when  a  user  performs   incorrectly/   the  system 

shoula   not   respond  immediately/  but  Oelav  from  two  to  four 

seconds.  Ihis  delay  allows  for  psycholoaical  closure  on   tne 

user's   part/   after   wrier  time  an  error  indication  is  more 
accept ab 1 e . 

The  logical  design  of  system  functions  thus  involved 
validation  of  existing  software/  aesian  of  new  software/  and 
constant  reflection  on  the  user's  osvcholooical  needs. 
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V.   DOCUMENTATION 


The  documentation  effort  in  this  tnesis  work  was  a  con- 
tinuous orocess  that  paralleled  all  other  phases  of  the  pro- 
ject. The  lack  of  sufficient  prior  documentation  was  con- 
sidered as  one  of  the  motivating  factors  oehina  this  work. 
This  deficit  was  certainly  one  of  the  major  hindrances  in 
performing  the  object  system  design.  Therefore*  the  formula- 
tion of  orooer  documentation  for  this  software  system,  in 
particular  a  well-conceived  user's  manual*  was  of  utmost 
importance  to  the  designers. 

An  attempt  was  m  a  d  e  *  tnrougrout  the  design/evaluation 
orocess*  to  record  every  finding,  every  result*  every 
achievement*  no  matter  how  insignificant  it  might  have 
seemed  at  the  time.  Tnese  notes*  though  seeminqly  unorgan- 
ized* served  as  valuable  reflections  during  tne  implementa- 
tion and  testing  phase*  as  well  as  when  this  writing  began. 

It  was  the  ultimate  goal  of  this  thesis  to  develop  a 
maximally  user-oriented  graphics  software  system  accompanied 
by  an  eaually  user-oriented  user's  manual.  Without  tne 
latter*  the  former  would  sorely  go  unrecognized  and  unused. 
With  this  in  mind*  a  creat  deal  of  thougnt  and  preparation 
were  devoted  to  develcpina  such  a  manual. 
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The  resulting  manual  (ApDendi  x  A)  is  organized  along 
the  following  lines.  First  there  is  an  introauction  to  the 
basic  system  environment  and  to  the  manual  itself.  Next  is  a 
guided  tour  of  the  steos  required  to  gain  access  to  this 
environment.  This  is  followed  bv  a  tutorial  review  of  the 
basic  programming  knowledge  a  user  should  possess  to 
approach  this  system  with  some  degree  of  conf iaence.  The 
next  chapter  actually  begins  to  reveal  some  of  the  features 
of  the  graohics  d  i  s  d 1  a  y  system,  and  exooses  the  oasic  pro- 
grammatic control  functions  the  user  will  need.  The  remain- 
ing chaoters  (except  the  last)  are  each  devoted  to  one  Par- 
ticular functional  capability  or  control  m  o  a  e  of  this  sys- 
tem. This  will,  hopefully,  orovide  a  more  systematic  revela- 
tion of  the  over-all  capabilities  and  features  of  the 
display  system. 

As  each  of  these  areas  is  explored/  the  associated  sys- 
tem functions  are  presented  in  a  top-down  fashion.  After  an 
introduction  to  the  oasic  application  area>  the  hian-level 
functions  are  int rocucea  first/  followed  by  progressively 
lower  level  functions.  This  approach  was  taken  in  an  attempt 
to  alleviate  the  difficulties  of  tne  novice  user  in  oaining 
familiarity  with  the  system. 

One  cnaoter  of  the  manual  is  devoted  to  each  of  the 
primary  interactive  devices  :  the  R  A  M  T  E  K  keyboard  a^o  the 
Vector  General  Tablet.  Tne  final  chaoter  presents  routines 
which   are  not  an     integral  part  of  any  particular  functional 
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area ,     and  had  thus  not  been  introduced   pari  ier,   but   which 
might  Drove  useful  in  sere  arol icat  ions. 

Trie  individual  system  functions*  in  the  L'  N I X  'format 
[63/  are  included  as  ^  o  c  e  n  d  i  x  B  for  further  clarification 
and/or  review  by  the  user.  In  addition/  a  cocy  of  the  source 
code  for  each  of  these  functions  (with  exolanatory  comments) 
is  available  in  the  N aval  Postoraouate  School  Laboratory. 


3  0 


VI.   r-'PLE^ENTATIOM  AND  TESTING 


A.   PREFERRED  TECHNIQUE 

Ideally  the  imolementation  chase  of  a  cofrouter  system 
design  should  only  account  for  <?S-30%  of  the  total  effort. 
The  functional  d  e  s  i  a  n  is  conolete  ana  a  detai led  users 
manual  exists  for  the  orooosed  system.  Actual  i mc 1 emen t a t i on 


should  then  consist 


t  est  i  no  . 


cod  inn,   deougoing,   and   localized 


The  cooing  effort  should  offer  little  challenge^  as  each 
function  has  been  laid  out  in  detail.  It  should  be  merely  a 
translation  of  ideas  into  a  suitable  medium  for  the  com- 
puter. The  deougoing  of  each  function  affords  more  of  a 
challenge,  as  without  fail  loaic  errors  will  exist  in  the 
basic  design. 

As  the  debugging  process  begins  the  documentation  must 
be  kept  current  or  in  the  end  the  documents  will  not  accu- 
rately aepict  the  system  as  it  actually  performs.  If  docu- 
mentation and  reality  ever  Pegin  to  diverge  then  an  unten- 
able situation  is  likely  to  he  created,  in  the  form  of  an 
unmaintainable  system. 

As  functions  are  brought  on-line,  local  testing  will  oe 
conducted   --   local   test ina  beina  those  tests  oerfor^eu  by 
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the  oerson  responsible  for  a  oarticular  functions  implemen- 
tation. Ihe  problem  with  this  local  testing  is  that  often 
the  testor  is  too  close  to  tKe  d  r  o  n  1  e  m  to  orovioe  a  good 
test.  After  the  local  testing  is  complete/  the  aetai led 
testing  of  the  function  should  be  performed. 

This  detailed  test  inn  should  be  oerformea  by  some  person 
or  preferably  some  qrcup  of  cersons  who  have  no  stake  in  the 
success  or  failure  of  the  system.  Ideally  this  testing  will 
be  done  by  a  team  which  would  soena  as  much  time  and  effort 
developing  the  test  clan  as  went  into  the  design.  All  too 
often  this  last  microscocic  testing  is  omitted/  with  the  end 
result  being  a  system  full  of  implicit  assumptions  and 
surprises  for  tne  unsuspecting  user. 


B.   MODIFIED  TECHNIQUE 

The  preferred  technique  could  not  ce  applied  to  this 
effort  ana  was  thus  modified  to  meet  certain  restrictions 
and  needs.  Hopefully  the  end  result  was  the  same  -  -  leaving 
a  viaole  ana  truly  use r-o r i en t ea  system.  The  reasons  for  the 
modifications  were  that  a  test  team  for  the  thesis  was 
unrealistic/  ana  that  an  existing  system  afforaed  a  point  of 
departure  in  search  of  tie  user-oriented  system. 

1  .'   \/ALIDATIOi\j/C0NDE.^NA  f  ION 

Due  to  the  fact  that  a  software  support  package   was 
already   in   existence   for  the  R  A  "»1  T  E  K  this  modification  was 
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injected.  It  amounted  to  having  three  erases  being  performed 
simultaneously.  The  three  chases  were  FUNCTION  DESIGN,  DOCU- 
MENTATION, ana  TESTING. 

While  operating  in  parallel,  as  oroposea  functional 
reguirements  were  enumerated/  the  existing  software  and  its 
associated  documentation  were  searched  to  determine  if  such 
a  function  already  existed.  Tf  the  exist  ina  system  possessed 
such  a  function  t^en  the  validation/condemnation  process 
began . 

This  orocess  *  a  s  fundamental,  as  it  eitner  v  a  1  i  a  a  t  e  a 
the  performance  of  the  function  or  it  caused  it  to  oe  con- 
demned. The  orocess*  though  si^cle  conceptual ly»  was  one  of 
the  most  difficult  and  time  consuming  stages  of  the  systems 
evolution.  If  the  function  performed  exactly  "as  a  a  v  e  r  - 
tised"#  then  the  action  was  to  ^erelv  document  and  continue. 
when  the  function  did  not  act  as  exoecteo,  then  the  often 
lengthy  ann  involved  search  began  *  or  the  sometimes  illusive 
logic  error. 

The  need  *  or  this  unrewaroing  exoerienc?  was  most 
certainly  created  by  inadeauate  testing  of  the  previous  sys- 
tem. This  inaoeouate  testing  hag  also  causea  the  "old"  s  v  s  - 
tem  to  fall  prey  to  idleness,  as  users  ao  not  relish  the 
thought  of  usina  a  s  v  s  t  e  m  full  of  frustration  and  surorise. 
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2.  IMPLEMENTATION 

The  funciamental  succort  functions  of  the  predecessor 
to  this  use  r-o  r  i  en  t  e  d  system  had  been  installed  and  tested 
prior  to  the  start  of  the  implementation  phase  of  the  moci- 
fied  approach.  The  volume  of  change  was  small  when  viewed 
against  the  entire  system  out  essential  in  a  truly  user- 
orient  ed  svste^. 

The  actual  cocing  effort  of  the  selected  additions 
to  the  now  dependable  base  system  only  accounted  for  a  c  o  r  o  x  - 
imately  10%  of  the  total  effort.  This  phase  was  actually 
conducted  exactly  as  discussed  in  the  PREFERRED  TECHNIQUE 
section.  Unce  the  coding,  debugging,  and  localized  testing 
was  complete,  tnen  detailed  system  testing  began. 

3.  DETAILED  TESTING 

The  detailea  testing  of  the  overall  system  was  con- 
ducted in  compliance  with  the  preferred  technique.  Ire  use 
of  an  external  testing  source  *  a  s  not  feasible,  thus  these 
suggestions  *ere  nent  slightly  to  accomodate  the  cir- 
cumstances of  the  design. 

The  dual  thesis  effort  afforoed  a  viaole  test  via 
oscillation  of  duties  between  aesigners.  The  person  respon- 
sible for  the  actual  implementation  of  a  function  was  not 
responsible  for  it's  testing.  Thus  the  designer's  counter- 
part became  the  d evil's  advocate  during  the  formal  test 
phase  . 
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In  addition  tc  the  formal  testina,  user  testing  was 
not  only  encouraged  but  souaht.  Tne  system,  when  possible, 
was  made  available  to  users  - -  reauestina  that  they  convey 
their  likes  and  dislikes/  successes  ana  failures.  The  sys- 
tem, having  oeen  designed  for  the  user/  was  then  evaluated 
very  critically  from  user  comments.  For  the  most  cart 
response  was  favorable.  When  unfavorable  responses  occurred 
they  were  studied,  anc  every  a  1 1  e  m  d  t  was  mace  to  restructure 
those  aspects  that  were  found  to  be  distasteful. 

4.   CONTINUED  TEST  IMG 

In  order  for  a  svstem  ro  really  claim  to  De  user* 
oriented/  it  must  ce  o  1  a  c  e  d  in  a  continual  test  posture. 
This  continual  testing  is  informal  but  allows  for  resDonse 
to  user  criticism.  The  user  is  afforded  the  facility  for 
voicing  his  problems  with  the  system.  These  user  assessed 
problems  must  be  evaluated  and  acted  upon.  The  action  need 
not  be  drastic,  ill-advised  system  modification/  but  an 
honest  look  at  the  oroclem.  If  corrective  actions  are  in 
order*  then  the  documentation  ana  software  must  be  modified 
in  unison. 

The  R  A  M T  E  K  G  X - 1 0  0  A  arachics  suocort  system  is 
currently  installed  and  undergoing  the  continued  testing 
ohase.  There  are  no  known  oroolems,  but  the  facility  for 
voicinq  such  pronle^s  exists  in  the  form  of  a  trouble  report 
attachea  to  the  device. 
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VII.   RECOMMENDATIONS 


The  system,  as  configured,  should  now  offer  a  produc- 
tive de  ve  1  oom  en  t  a  1  environment.  This  newly  created  environ- 
ment will;  hopefully,  encourage  fresh  innovative  research  in 
new  applications  of  color  araoMcs.  Two  such  areas  surface 
almost  immediately  as  likely  candidates  for  meaningful 
research.  These  two  areas  are: 

COMMAND/  CONTROL,  AND  COMMUNICATION;  ano 

SIGNAL  PROCESSING. 

Tne  command*  control,  and  communication  aool  icat  ions 
are  bounced  by  imagination  alone,  as  this  field  is  still 
evolving.  The  field  of  computer  graphics  will  most  surely  be 
one  of  the  front-runners  in  the  implementation  of  such  sys- 
tems. The  c  o  !  o  r  capabilities  of  the  R A M T E K  should  provide  a 
powerful  tool  in  this  reoaro. 

Limited  signal   cocessino   aool icat ions   have  already 

been    performed   on   the   device.   Tne   new   system  should 

encourage  more  use  of  color  in  this  area.  The  color  disolay 
will  most  certainly  ccnvev  more  useful  information. 

In  addition  to  the  new  applications,  it  would  De  bene- 
ficial if  the  saving  of  complete  screen  images  were  cossi- 
ble.  The  memory  space  reauireo  for  this  aooli  cation  would 
require   serious   consideration   out   could   be  ar ranoed  to 
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permit  efficient  utilization.  The  memory  readoack  interface 
was  not  installed  on  this  eauip^ent >  out  with  its  installa- 
tion ana  minor  software  efforts  it  wouM  be  possible  to 
memorize  screen  images.  This  memorization  process  could 
eliminate  the  need  for  repetitive  processing  while  providing 
a  powerful  tool  for  the  user. 

The  support  Horary  exists  as  a  separate  entity  and  is 
intefaced  via  the  C  crcoramT-inc  lanauage.  Possible  research 
on  the  cap9Di  I i  ty  to  access  this  Horary  via  ether  languages 
would  be  a  worthy  experience. 

The  ever  continuing  maintenance  of  this  and  all  of  the 
systems  is  of  .the  'utmost  inoortance.  Similar  efforts  as  con- 
ducted on  the  R A ■  M T E K  coul 1  oe  undertaken  for  other  grapics 
devices  in  the  labora^nrv. 
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v  I  I  I  .   CONCLUSIONS 


An  existing  software  support  package  was  d i sassemb 1 ed , 
then  re s t rue t u red ,  tested*  and  expanded  into  a  usable  color 
graphics  aisolay  svstem.  The  goal/  as  a  user-oriented  sys- 
tem, was  achieved;  but  the  design  approach  and  the  solutions 
to  problems  encountereo  offered  the  real  lessons  in  t  ru  s 
learning  process.  These  were  the  ■■nest  imoortant  results  to 
the  designers. 

In  recesigning  a  software  system  based  on  a  orior 
design^  it  was  oossible  to  have  20/20  hindsiaht  info  the 
failures  of  the  orevicus  a  t  t  e  m  o  t  .  The  most  profound  judge- 
ment deriveo  is  that  detailed  olanning  must  precede  imole- 
mentation  efforts.  The  parent  system  that  soawnec  this 
user-oriented  child  was  not  olanned  in  detail  nor  well  docu- 
mented, ^aci  the  steos  utilized  in  developing  this  new  design 
been  employee  in  tie  previous  effort,  tnere  would  Probably 
have  oeen  no  need  for  major  revision  ana  exhaustive  testing. 

Ihe  system  has  oeen  installed  anc  tested.  Adequate 
documentation  has  oeen  provided  to  assist  users  in  the  effi- 
cient use  of  the  oevice. 
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APPENDIX  A 


USERS  MANUAL  RAMTEX  GX-100A 


This  manual  is  designed  to  D  r  o  vi  d  e  the  users  of  the  R  A  M  T  E  K 
graphics  display  device  a  convienient  and  s  i  m  o  1  e  introduc- 
tion to  the  device.  The  manual  allows  for  as  detailed  an  in- 
vestigation into  the  system  as  the  user  desires. 
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I.   INTRODUCTION 


The  K A M T £ K  G X - 1 0 0 A  graphics  display  system  utilizes  a 
raster  scan  techniaue/  with  the  disolav  image  data  o  e  i  n  g  ex- 
tracted from  an  internal  refresh  memory.  The  RAMTEK  system 
in  the  Naval  Postgraduate  School  Computer  Laboratory  is 
hosted  dv  a  PDP-11/50  computer  and  is  accessed  through  this 
computer*  ana  its  UNIX  operating  system,  from  one  of  the 
terminals  in  tne  Lao. 

It  is  not  the  intent  of  this  manual  to  orcviae  a  de- 
tailed analysis  of  the  hardware  or  internal  functions  of  the 
RAMTEK  device*  but  rather  to  expose  the  user  to  the  software 
support  pacoae  that  has  been  aeveloceo  for  it.  This 
software  package  consists  primarily  of  a  system  library  of 
subroutines  written  in  tne  ' C  *  oroaramming  language.  Includ- 
ed in  this  Horary  are  a  number  of  routines  that  enable  the 
user  to  interface  the  R  A  ,v  T  £  K  with  the  Vector  General  Data 
Tablet  in  the  Lab. 

A  review  of  the  Table  of  Contents  would  reveal  tne 
basic  organization  of  this  manual  to  oe  as  oescribea  here. 
Following  this  Introduction  is  a  chapter  devoted  to  fami- 
liarizing the  user  with  the  environment  in  which  this  oraph- 
ics  system  exists.  The  next  chaoter  oresents  the  fundamen- 
tal  proaramming   knowledae   reauired  of  a  prospective  user. 
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Following  this*  the  basic  control  functions  of  this  system 
are  described.  Next  the  user  is  introduced  to  the  data  ta- 
blet interfacing  routines,  followed  by  color  manipulation 
techniques.  After  this*  there  are  eioht  chapters  that  each 
describe  one  of  the  control  mooes  of  the  GX-100A.  Then  comes 
a  chapter  detailina  the  use  of  the  interactive  keyboard.  Tne 
final  chapter  discusses  the  remairoer  of  the  software  sup- 
port oackage.  Ahere  appropriate,  the  separate  chaoters  are 
divided  into  three  sections  :  Introduction,  basic  User 
Guidelines,  and  Advanced  Methods. 

The  manual  will  serve  as  a  tutorial  on  tne  subroutines 
available  to  the  user  for  gereratina  displays  on  the  R A M T E K 
terminal.  There  are  numerous  samole  programs  included  to  al- 
low the  user  to  become  familiar  with  operating  the  system 
and  to  exhibit  certain  features  that  are  available  in  the 
R  A  M  f  E  K  software  support  oackaae.  These  sample  orograns, 
alono  with  several  laraer  demonstration  programs,  have  o e e n 
compiled  into  a  special  directory  in  the  host  computer  file 
system  (see  Operating  Instructions).  The  user  is  encouraged 
to  execute  each  of  these  samples  as  he  progresses  through 
this  manual. 


For  the  user  that  reauires  a  ^  o  r  e  detailed  knowledge  of 
the  internal  functioning  of  the  device,  the  R A M T E K  GX-10  0A 
Programmino.  Manual   [1]  is  available  in  tne  Lab. 


a  a 


Black    &    White 


Color 


1 —  Brightness 


Power 


f-  I  fiiiWfc      1 


US 


II.   OPERATING  INSTRUCTIONS 


The  RAMTEK  display  aevice  is  accessea  via  the  "A"  sine 
PDP-11/50  in  the  Computer  Lab  bv  using  one  of  the  terminals 
connected  to  this  computer.  If  the  user  is  not  familiar  with 
the  operation  of  these  terminals/  he  should  consult  the  Ter- 
minal User's  Manual  I c ]  available  in  the  Lao. 

In  order  to  utilize  the  R  A  M T  E  K »  the  device  must  be 
"cowered-on"  and  supported  by  the  PDP-11/50  computer,  fly 
following  the  \d  steps  listen  be'ow,  tne  user  will  ensure 
himself  o  *  a  successful  session  with  the  eguipment. 

1.  Ensure  the  "A"  side  PDP-11  comouter  is  in  operation. 

(If  in  doubt/  check  with  Lab  staff.) 
d  .  Check  the  green  Dower  supply  light/switch  (marked 
"RAMTEK  POWER")  at  the  lower  rear  of  the  host  PDP-11. 
If  this  switch  is  NOT  illuminated/  contact  one  of  the 
Lab  personnel  for  assistance.  Indiscriminate  use  of 
this  switch  will  cause  the  host  system  to  "crash". 
3.  Apply  power  to  the  RAMTEK  kevboara  and  monitor  : 

a. the  areen  "POWER"  swi  ten  on  the  upper  right  orr- 
t ion  of  tne  kevboara  should  re  illuminated?  if 
not/  deDress  tne  switch, 
b.  select  the  " 0 N "  cosi t  ion  of  tne  selector  <  n  o  b  at 
the  lower  left  corner  of  f  h  e  color  display  moni- 
tor. (See  Fiq.  1) 
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c.  (optional)  select  the  "U^1"  oosition  of  the  power 
switch  on  the  lower  front  d  a  n  e  1  of  the  black  & 
white  monitor  (See  Fig.  1) 

a.  (optional)  select  the  "ON"  oosition  of  the  cower 
switch  on  the  Vector  General  Data  Tablet. 

4.  Choose  one  of  the  "A"  side  ter-ninals  and  turn  it  on. 

At  this  point/  the  user  is  reaay  to  log  into  the  UNIX 
ooerati na  system  ana  proceed  with  the  session.  The  user  that 
intenas  to  execute  one  or  nore  of  the  samole  programs  from 
this  manual  or  view  ere  of  the  R A M T E K  demonstration  programs 
shoula  continue  with  steo  S.  For  the  user  that  has  been  es- 
tablished in  the  system  with  his  own  identification  and 
directory^  the  most  common  activity  is  orogram  development 
and  test ina.  This  user  is  assumed  to  he  familiar  with  the 
operatina  environment  and  is  referred  to  Chapter  I V ,  Pro- 
grammatic Control  of  the  RANiTEK.  The  user  with  only  moderate 
exoerience  in  the  UNIX  environment  may  *  i  s  r,  to  scan  Chapter 
III/  3asic  Programming  Reou i remen t s /  before  proceeding  to 
Chaoter  IV.  These  users  may  return  to  step  10  below  for 
termination  Procedures. 

5.  At  the  selected  terminal/  the  completion  of  the  fol- 
lowina  sequence  will  lead  the  user  to  the  system 
directory  that  contains  the  samole  and  demonstration 
orograms  (note  :  lower-case  tyce  implies  a  user-tyced 
command/  uoper-case  tyoe  denotes  a  system  reol y ;  " % " 
is  the  Urvlx  prompt  signal/  and  "c/r"  means  depress  the 
RcTU^N  key)  : 


47 


LOGIN:  cs2000    c/r 

PASSWORD:  student    c/r 

%  c  d  ramte'<    c/r 
to.  To  determine  what  source  programs   are   available   for 
inspection^  the  user  should  type  : 

Is  *  .c  c/r 
This  will  result  in  a  listina  of  the  names  of  all 
files  in  the  cs2000/ramtek  li  rectirv  that  are  of  tvoe 
".c".  This  list  of  file  names  will  appear  on  the  ter- 
minal screen.  The  files  that  are  named  pl.c  through 
o  2  0  .  c  are  sample  programs  tnat  are  describea  later  in 
this  manual.  The  other  files  listed  are  of  no  concern 
to  the  user  at  this  time. 

7 .  To  inspect  one  these  files/  the  user  should  tyoe  : 

list   -c   filename. c      c/r 

c/r 
where  "filename"  denotes  the  name  of  the  particular 
chosen  file.  T he  second  (ana  subsequent)  "carriage 
return"  will  cause  the  next  "oage"  of  source  code  to 
be  printed  on  the  terminal  screen.  For  example/  to 
inspect  the  source  code  of  the  first  sample  program/ 
the  user  would  type  : 

list  -c  pl.c  c/r 

8.  To  execute  one  of  the  samole   Programs   and   view   the 
resulting  display  on  the  R4MTE*/  the  user  should  type: 

filename. x    c/r 
where  "filename"  is  the  name  of   the   selected   sample 
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program.   After  decressi^a  the  RETURN   key;   the   user 
should  turn  his  attention  to  the  disnlay  screen. 

9.  In  addition  to  the  sample  pro o rams  mentioned  above? 
there  are  also  four  demonstration  orograms  in  the 
cs<2000/ramtek  directory.  A  detailed  explanation  of 
these  demo  orcarams  can  be  found  in  the  "User  Entry 
Manual"  (21.  Tc  view  the  first  of  these  demonstration 
programs?  the  user  should  tyDe  : 

rami    c / r 
Subseauent  demo  programs  are  cell  en   ram d t        ram  3/   and 
ram4.  These  demo  orograms  offer  the  user  the  opportun- 
ity to  interact  with  the  R A M T E K  keyboard  ana  the   data 
tablet. 

After  completing  the  oesired  work  for  one  session/   the 
user  should  croceed  tc  steo  10  for  termination  procedures. 

10.  For  the  user  who  is  currently  editina  a  file  (ie, 
creating  or  nodi  f yinq  a  file  in  his  own  or  a  class 
directory)*  care  must  ce  ta*en  to  ensure  the  latest 
add i t i ons /co r r ec t i on s  ere  incorporated  into  ris  pro- 
aram.  This  is  accomplished  cv  tyoinq  at  the  terminal  : 

w   filename    c/r 
Then  typing  : 

a    c/r 
will  get  the  user  out  of  the  "edit"  mode.   (see   Chac. 
Ill  ) 

11.  To  terminate  the  session  on  the  terminal/  tvoe  : 

ou  i  t    c/r 
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12.  To  "sower   down"   the   3  A  v  T  t  K  ,   the   following   steos 
should  be  accomplished  : 

a  .  Turn  off  the  green  power  switch  on  the  R  A  v  T  E  K 
keyboard  by  depressing  trie  switch. 

b.  Select  the  "OFF"  oosition  of  the  selector  knob 
at  the  lower  left  corner  of  the  color  oi  spl ay 
m o  n  i tor. 

c.  If  the  black  $  write  monitor  is  on ,  select  the 
"OFF"  oosition  of  its  oower  switch  on  the  lower 
f  ron t  cane  1  . 

d.  If  the  Vector  General  Tablet  was  being  used* 
select  the  "OFF"  nosition  of  its  oower  switch. 
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III.   BASIC  PROGPA^^riG  REQUIREMENTS 


In  order  to  utilize  the  R  A  ^  T  E  K  d  i  s  d  1  a  y  device  the  user 
must  have  access  to  the  comouter  laboratory  and  a  loain  name 
in  t  r>  e  UNIX  time  sharina  system.  The  fact  that  the  user  is 
estaolished  in  tne  UNIX  ooeratinq  system  allocates  the  scace 
reauireo  for  croaram  cevelocment  .  There  are  two  separate 
POP-  11/50  comouters  in  the  laboratory  ana  they  are  referred 
to  as  the  "A"  and  "B"  sides.  i"he  "A"  side  hosts  the  graohics 
display  devices  of  the  laboratory!  the  " 8 "  side  is  usee  for 
general  crcgraT  develoDment •  In  order  for  a  user  to  effec- 
tively utilize  the  system  se  should  rave  access  to  both 
sides  .  This  allows  the  user  to  create  and  oebuq  programs  on 
the  "8"  sioer  then  execute  the  programs  on  the  " A "  sioe. 

The  C  orocraiiTing  language  (3)  *as  used  to  d  e  v  e  1  o  d  the 
software  suocort  for  tr>e  PA""1Ek  an-j ,  as  such,  tre  user  will 
be  required  to  program  in  C  in  order  to  interface  *  i  t  n  this 
software.  The  C  lanauaoe  is  similar  to  FORTRAN  out  orovioes 
a  areat  deal  more  flexibility.  A  C  program  consists  of  data 
declarations  a  no1  one  or  more  functions.  This  language  has 
five  fundamental  data  tyoes: 

1 n  t  (integer) 

char  (by t e ) 

float  (single  precision  floating  point) 

loubl e  (double  crecision  float  mc  ooint) 
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reoi ster  (same  as  int  excect  in  a  reoister) 
Declarations  may  be  n-ade  internally  or  externally,  with 
respect  to  a  function,  indicat inn  either  local  or  global 
scope  respectively.  Global  score  implies  that  the  variable 
is  known  to  all  functions  that  follow;  local  scope  implies 
that  only  the  function  t^at  contains  the  declaration  has 
knowledge  of  that  variable. 


A  function  consists  of  a  set  of  statements  enclosed  in 
braces  ({}).  Every  C  rrocram  must  contain  a  function  called 
"main"  since  execution  of  a  C  orogram  begins  with  the  first 
statement  of  "main".  All  functions  must  be  explicitly  de- 
clared (includinq  "main")  by  a  statement  of  the  form  : 
f unc t i on-name ( oc t i ona 1  arguments).  Tne  optional  arguments 
are  the  wav  that  data  are  communicated  between  functions. 
The  arguments  must  te  enclosea  in  ca^enthesis  and/  even  if 
no  arguments  exist,  the  oarenthesis  must  always  be  oresent. 
The  statements  within  a  function  a  r°  always  terminateo  with 
a  semi-colon  and,  as  creviously  stated,  the  boav  of  the 
function  is  enclosed  in  braces.  "Main"  will  normally  invoke 
other  functions  to  o  e  r  f  o  r  m  certain  tas<s,"  this  is  accom- 
plished by  stating  the  function  name  followed  by  the  argu- 
ment list  ano  terminated  by  a  semi-colon. 


With  this  very  cursorv  lno<  at  the  C  programming 
language  the  user  should  ne  aole  to  unoerstand  the  example 
orograms  o  *  this  manual  ano1  write  simple  C  orogram  s.  The 
user   is   encourageo   to   re^o   the  C  tutorial   [  4 ]  ana  the  C 
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reference  manual  [3]  for  a  more  detailed  description  of  the 
1 anguaqe . 

It  is  assumed  here  that  the  user  has  some  knowledge  of 
the  UNIX  operating  system,  at  least  to  the  level  of  having 
read  the  "UNIX  for  Beginners"  tutorial  (51.  Thus  he  will 
understand  that  files  may  be  created  by  invokina  the  UNIX 
TEXT  EDITOR,  qiving  the  command  to  aooend  information  to  the 
filer  inserting  the  information/  terminating  the  apcena 
mode*  ann  writing  the  file.  The  following  short  exercise 
should  refresh  the  users  memory. 

LOGIN':  "user  locin  name"    c  /  r 

PASSWORD:  "user  cassword"    c / r 

ed  samole.c  c/r  (invokes  text  editor) 

a    c/r  Center  aooend  mode) 

ma  i  n ( )    c/r 

{ i  nt  a/O, total;    c/r 
a  =  1 ;  b  =  2 ;     c/r 
tota1=a+b;    c/r 
p  r  i  n  t  f  C " s  u m  is  %d0, total);    c/r 
}  c/r 

c/r 
w    c/r  [write  file) 

q    c/r  (ouit  edit  mode) 

This  example  creates  a  file  (C  orogram)  called  samole.c 
that,  when  compiled  and  executed  sums  two  integer  val u°s  a 
and  b  into  total  ana  then  prints  the  result. 
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The  user  should  recall  that  in  order  to  compile  a  C 
program  he  must  invoke  the  C  compiler  by  using  the  "cc"  com- 
mand. To  comcile  the  above  examole  the  user  would  type  : 

cc  same  1 e  .  c  c / r 
The  result  of  a  C  comoile  is  an  executable  file  named  a. out. 
This  file  is  created  if  one  ooes  not  already  exist  or  re- 
places the  old  a. out  file  if  one  existed  previously.  In  ord- 
er to  save  an  old  a. out  file  the  user  may  rename  it  bv  util- 
izing the  UNIX  function  " m v w •  For  the  user  to  save  the  a. out 
file  created  by  comoiling  samole.c  he  could  tyoe  :  m  v  a. out 
sample  c/r  .  This  cnanges  the  na^e  of  a. out  to  sample. 

having  been  refreshed  on  the  very  basics  of  the  C  pro- 
gramming language*  UNIX/  and  compilation  procedures,  the 
user  is  reaay  to  begin  writing,  compiling,  and  executing 
programs  specifically  f o  r  the  K  A M T  E  K  graphics  display  dev- 
ice. The  user-oesicnec  oroqrams  'of  the  RAMTEK  will  be 
depenoent  uocn  the  RAMTEK  software  suooort  library,  This  li- 
brary contains  a  multitude  of  us?r  oriented  routines  that 
allow  him  to  oerforTi  certain  tasks  on  the  oevice.  These 
routines  are  actually  C  •'unctions  and  in  order  to  invoke  one 
the  user  must  onlv  mention  it's  name.  Since  this  suDport 
routine  is  not  within  the  user  aefined  C  o  r  o  g  r  a  m  ,  it  is  un- 
defined unless  a  link  is  orovideo  to  the  suooort  library. 
This  link  is  provided  via  a  shell  commano  callea  "ramtek". 
Thus  in  order  to  comoile  a  oroaram  that  references  functions 
contained  in  the  licrary,  the  user  tyoes  : 

ramtek  filename.c    c/r 
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This  will  issue  a  cc  command  with  the  appropriate  parame- 
ters to  link  to  the  software  supoort  Horary  ana  resolve  tne 
previously  undefinea  function  calls.  Ihe  following  e  x  a  m  d  1  e 
typifies  this  orocedure: 

LOGIN:  "loain  n=»me"    c/r 

PASSWORD:  "user  password"    c/r 

ed  CT5.c    c/r 

a    c/r 

ma  i  n ( )    c/r 

(ramtekO;  erased!    c/r 

d  i  s  o  (  7  )  ;    c/r 
}  c/r 

C/r 
w  c/r 
a    c/r 

ramte*  C  T5  .  c   c/r 
The  result  of  the  above  example  will  be  the   creation   of   a 
file   CIS.c  (the  source  code)  and  an  a. out  file  (the  execut- 
able file). 

As  previously  stated  the  user,  for  efficiency  reasons, 
should  create  and  comcile  his  programs  on  the  "6"  side  of 
the  laboratory  facilities.  If  the  user  has  followed  this 
guideline  he  now  has  an  executable  Drogram  that  will  display 
some  colors  and  text  on  the  P A M T E K  screen  (the  user  should 
not  be  concerned  with  how  this  is  done,  but  merely  with  the 
procedure);  but  the  executable  program  is  on  the  "8"  side 
and   the   "A"   side  actually  nosts  the  graohics  aisul ay  oev- 
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ices.  The  user  must  then  transport   his   executable   program 
from  the  "B"  siae  to  the  "A"  siae. 

The  transportation  of  information  from  the  "6"   to   the 
"A"   side   may  be  accompli  s  n  e  d  bv  using  the  system  functions 
"put"  and  "get".   In  order  for   the   user   to   transfer   the 
a. out  file  created  from  the  cnmpilation  of  CT5.C  he  must: 
(l)be  logged  in  on  both  sides  simultaneously 
(2)  from  t^e  "B"  side  tvce 
put  a. out  c/r 
(the  system  will  respond  DO WE  when  t^e  action  is 
como 1 e  t  e ) 
( 3 ) f  r  o  m  the  " A "  side  tyoe 
get  a  .  ou  t  c/r 
(the  system  will  respond  with  DONE  when  finished) 
Now  the  a. out  file  createa  earlier  resides  on  botn  sides   of 
the   laboratory's   PDP   11/50   computers.   The   user  is  also 
loggeo  in  on  both  sides  and  should  logout  of  the  "ti"  side  in 
consideration   of   other  users.  The  user  may  now  execute  his 
program  and  see  the  P  A :  <1  T  E  K  response,  Prior  to  execution   the 
user   should  ensure  that  the  G  X  -  1  0  A  A  is  oowered-on  according 
to  the  first  three  steos  in  the  chapter  titled  OPERATING  IN- 
STRUCTIONS.  For  the  user  to  now  execute  the  program  he  must 
type  :  a. out  c/r     .  I  n  e  ^  A M T  E  K  should  resoona  with  a   disci  ay 
of   assorted   colors  and  alphanumeric  data  on  the  screen  ana 
the  terminal  should  respond  with  the  %    prompt. 
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The  user  may  also  use  IMP(]  and  EXPO  (see  UNIX  pro- 
grammers manual  [b]  )  for  t- n  e  transportation  of  information. 
These  routines  orcvioe  two  way  communication  but  have  cer- 
tain restrictions  that  make  them  a  secona  choice. 

The  user,  having  followed  the  CTb.c  example  to  comple- 
tion, now  has  two  copies  of  the  same  file.  One  file  is  on 
the  "A"  side  ana  the  other  file  is  on  the  "  3  "  side.  This  du- 
plication of  cooe  is  a  waste  of  space  and  as  such  the  user 
should  remove  one  of  the  copies.  This  removal  can  oe  accom- 
plished by  using  the  system  routine  "  r  m "  .(type  rir  a. out  c/r) 

The  user  is  now  preoa^e^  to  move  into  the  specifics  of 
the  R  A  M  T  E  t\  support  oackaie.  for  more  detailed  information  on 
C  ,  UNIX,  and  the  use  of  system  terminals,  refer  to  the  a  o  - 
propriate  document  in  the  laboratory. 
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IV.   PROGRAMMATIC  CONTROL  OF  THE  RAMTEK 


A.   Openinq  the  Device 

There  is  one  1  i  o  r  a  r  v  sun  routine  that  iv<  U  S  T  be  called  in 
every  program  that  applies  to  the  R  A  w  T  E  K  ,  and  it  must  also 
be  the  first  s  u  c  h  subroutine  called.  This  routine*  aooropri- 
ately  named  "ramte<"*  opens  the  aevice  and  establ isnes  user 
access  to  it.  This  will  also  clear  the  screen  (and  the  re- 
fresh memory)  of  any  prior  aisolav.  The  call  may  a  o  p  e a  r  as 
follows  : 

ramtekC); 
As  mentioned  mere*  this  must  be  the  first  R  A  M  T  E  K  subroutine 
call  in  the  user's  pro a  ram.  This  routine  will  return  a 
value  of  negative  one  (-1)  if  unacle  to  ooen  the  device* 
otherwise  it  returns  a  zero  value.  The  return  of  a  neoat  i ve 
number  to  indicate  an  error  conoition  is  common  practice  in 
this  system  ana  its  ooeratina  environment.  The  user  should 
consult  Apoenaix  b  to  fine  the  orooer  ciaanostic  information 
for  each  routine  in  the  software  supoort  packaoe. 
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B.   Virtual  Screen  Dimensions 

In  order  to  develoo  functional  programs  for  acol  icat  ion 
to  the  R A M T E K ,  the  user  must  be  aware  of  the  conceot  of  the 
"virtual"  screen^  w  n  i  c  h  means  the  user's  view  of  the  screen 
will  differ  from  the  real  hardware  configuration.  The 
displav  screen  may  be  thou ant  of  as  being  made  uc  of  2  4  0 
horizontal  lines,  each  consisting  of  fc>  4  0  elements.  (Each 
line/element  comoi  nation  is  called  a  "pixel".]  In  real  i  tv^ 
this  device  has  51?  raster  lines.  Due  to  certain  interfacing 
restrictions  it  has  been  modified  to  allow  only  u&O  of  these 
lines  to  be  visiole.  The  other  32  lines  exist  off  the  bottom 
of  the  scree"  and  are  of  no  concern  to  the  user  exceot  when 
the  "scroll"  routine  is  employee,  (see  Soecial  Apoli  cations 
Routines"/  C  h  a  c  X  V  I  )  .  All  other  disolav  routines  in  the  suc- 
port  package  mao  the  user's  addresses  onto  the  48  0  visible 
lines.  Since  this  G X - 1 0 0 A  accesses  these  visible  lines  in 
Dai  rs  rather  than  individually/  the  result  is  2^0  adoress- 
able  lines.  Thus  the  initial  view  of  the  screen  could  be 
that  of  a  6  4  0  bv  240  arid  with  the  coordinates  (0,0)  in  tne 
upper  left  corner  and  the  coordinates  (b'40,2'40)  in  the  lc«er 
right  corner.  This  is  NOT  the  view  that  is  used  when  operat- 
ing through  the  R A M T E K  suoport  package. 

The  software  succort  routines  have  been  designed  to 
transform  the  screen  into  the  more  conventional  "Cartesian" 
gria  oattern  that  has  its  minimum  values  in  the  lower  left 
corner   and   its   naxinu-   values  in  the  uccer  riant  corner. 
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Thus  the  user  views  a  virtual  screen  as  described  by  an   or- 
dinary Cartesian  grid  system. 

It  should  be  noteo  here  that  the   initializing  "ramtek" 

routine  dimensions  the  virtual  screen  to  100  X  1 0  0  f  with  the 

lower  left  corner  representing  the  point  (0.0,0.0)  and   the 
upper  right  corner  (10  0.0,10  0.0). 

By  utilizing  the  routine  called  "screen"  the  user  may 
dimension  the  virtual  display  screen  to  any  desired  size,  as 
long  as  the  coordinates  con-form  to  the  conventional  pattern. 
The  call  is  of  the  form  : 

screen(xTin,ymin/xrn3x,ymex)/ 
where  the  parameters  are  real  numbers  that  represent  the 
minimum  and  maximum  ranges  for  the  conventional  Cartesian 
coordinates.  After  dimensioning}  the  screen  to  the  desired 
size,  the  user  may  relv  upon  the  software  suooort  package  to 
convert  any  set  of  cocrai nates  that  are  valid  for  that  grid 
system  into  the  proper  real  screen  location,  (see  "conve" 
and  "convl"  in  Chapter  X  V I ,     Special  Aoplications  Routines) 

C.   Virtual  Screen  Addressing 

The  user  has  no*  cefined  the  address  space  for  the  vir- 
tual screen,  and  may  choose  the  ooint  from  which  the  display 
should  begin.  Tnis  involves  the  location  of  the  Current 
Operating  Position  (C0D).  The  COP  is  initially  located  at 
the  lower  left  corner  of  tke  screen.  This  is  the  case  after 
every   call   to  the  "screen"  routine.  A  new  location  for  the 
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COP  may  be  established  by  using  the  "strtxy"  routine  and 
passing  as  carameters  the  virtual  x,y  coordinates  of  the 
desired  starting  point.  This  call  should  oe  of  the  for-n  : 

stPtxy(x/y)J 
where  x  and  y  are    real  numbers.  The  COP  is  modified  by   most 
of   the   actual  disolay  routines*  as  explained  in  subseauent 
chapters  of  this  manual.  Therefore  the  user  must  confirm  its 
location  prior  to  attemptinq  to  o  i  s  d  1  a  y  another  imaqe. 

There  are    three  modes  of  adoressina  the  RAMTEK  screen   : 
absolute?  relative*  ana     indexed. 

1.  Absolute  addressing  is  the  normal  or  default  mode. 
The  starting  ccint  (COP)  for  a  Tisolay  is  selected  by 
use  of  the  "strtxy"  routine.  Tne  ending  COP  deoends  on 
the  current  control  mode  (Chap  VII  -  X  I  V  )  ,  and  the 
tyoe  of  display  that  is  generated. 

2.  Relative  addressing  is  only  acol icanl°  to  the  graph- 
ics control  mones.  Its  only  use  is  throuah  the  routine 
called  "oointr".  Tne  real  numbers  cassed  as  Parameters 
in  "point r"  are  summed  with  the  x  a^a  y  values  of  the 
last  COP  to  derive  the  next  COP.  This  allows  the  user 
to  generate  such  displays  as  a  sequence  of  vectors 
drawn  relative  to  each  ether,  without  computing  the 
actual  screen  coordinates  of  all  the  end  points.  As  an 
example*  if  the  COP  was  located  at  (10.0*10.0)  ana  the 
user  issued  the  command 

oointr(5. 0,-5.0); 
the  new  COP  would  be  located   at   (15.0,5.0).   If   the 
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user  was  ooeratinq  in  the   Graohic   Vector   mode/   the 
above   call   would   have   drawn   a  vector  from  virtual 
screen  ooint  (10.0/10.0)  to  ooint  (15.0,5.0). 
3 .  Inaexed  addressina  is  turned  on  ana  off  by  use  of  the 
"index"  routine.  A  call  of  the  form 

innex(i,x,y); 
where  i  has  the  inteaer  value  1,  woulc  initiate  in- 
dexed addressinq.  All  subseauent  instructions  would  be 
interpreted  with  resoect  to  the  x  ana  y  parameter 
values  in  that  call.  This  address  m  a  o  o  i  n  n  is  done  Oy 
summinq  any  subseauent  screen  address  with  these 
values  to  determine  a  new  COP.  For  example/  if  the 
following  subroutine  calls  were  issued 

i  n  d  e  x  (  1  ,  2  .  0  ,  2  .  0  )  ; 
s  t  r  t  x  y ( 3  .  0,3.0); 
the  COP  would  be  located  at  the  virtual  screen  coorqi- 
nates  (5.0,5.0).  This  address i no  scheme  can  be  e  m  - 
Dloyeo  in  any  of  the  control  mooes.  Indexed  addressing 
is  terminated  by  issuing  another  index(i,x,y)  call, 
with  the  parameter  i  having  a  value  of  zero.  In  this 
case/  the  x  and  v  oarameters  are     iqnored. 

D.   Control  M  c  o  e  s  and  Flaos 

Programmatic  control  of  the  GX-100A  aisolav  device  in- 
volves selecting  one  o  *  eight  control  modes.  Each  of  these 
modes  is  affected  cy  certain  control  flags.  A  seoarate 
chapter   in   this   manual   is  devote^  to  each  of  the  control 
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modes.  A  description  of  the  five  control  f 1 aas  is   presented 
here . 

IX  -  Indexed  Addressing 

The  effect  of  indexed  addressing  is  explained  above  in 
Virtual  Screen  Addressing,  along  with  a  discussion  of  its 
controlling  routine  called  "index". 

BK  -  Keverse  Background 

When  setf  this  causes  a  "reverse  oolarity"  in  the  color 
selection  orocess.  It  effectively  reverses  or  inverts  the 
current  color  table.  The  areas  of  tne  screen  that  were  being 
shown  in  color  entry  0  (normal  background  color)  will  be  re- 
verted to  color  entry  15,  and  vice-versa.  (.see  Chao  VI, 
Color  Displays)  This  flag  is  turnea  on  and  off  by  the 
"bkrnd"  routine.  The  f  1  a g  would  be  turned  0  >NJ  if  the  parame- 
ter o  was  given  the  value  1  in  the  following  call  : 

bkmd(b)  ; 
If  o  was  given  a  zero  value  the  flag  would  ce  turned  OFF. 

Aw  -  Additive  Urite 

(/vhen  set,  the  generated  imaae  is  combined  with  the  image 
already  being  projected  at  a  particular  location.  This  m  a  v 
be  used  to  combine  characters  into  special  characters, 
create  overlay  type  disclays,  or  display  some  character 
close  to  another  imaae  without  destroying  a  portion  of  that 
image  with  the  seven  by  twelve  pixel  matrix  used  in  display- 
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i nq  alphanumeric  characters,  (see  Chap.  V 1 1 >  Alphanumeric 
Mode)  The  control  of  this  flag  is  accomol is^ed  by  the  " wri- 
ton"  routine.  As  before,  if  the  single  parameter  is  a  1  the 
flag  is  turned  on;  if  it  is  0  the  flaa  is  turned  off.  The 
call  should  aooear  as  follows  : 

w  r  i  ton(w)  ; 
where  w  represents  either  0  or     1.  (See  Appendix  B  for   error 
d  i agnos t  ics) 

Ow  -  Double  Width 

When  setr  the  iracp  beino  displayed  is  aoubled  in  width 
from  its  norma)  size/  i  e»  where  one  element  was  being 
"  painted "  two  consecutive  elements  on  that  line  are 
displayed  in  the  selected  color.  The  desired  character  size 
(normal  or  double  width)  m^v  be  selected  by  using  the  "size" 
procedure  as  follows  : 

s i ze ( s  )  ; 
where  s  is  either  I  or  2 t     rerresentinq  normal  or    double  wide 
respectively.  (See  Appendix  B  for  error  diagnostics) 

FP  -  Fixed  Point 

When  setr  this  causes  the  (next)  established  COP  to  be- 
come the  common  starting  point  for  all  subsequent  end  points 
issued  in  araphic  vector  ann  plot  aenerat ion.  (see  the 
Chapters  on  arapMcs  mooes)  Th«=  fixed  noint  flaa  is  turned 
on  ang  off  by  the  routine  named  "fixer".  This  single- 
parameter   function   acceots   either  a  zero  (to  turn  off  the 
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flag)  or  a  one  (to  turn  on  the  flaa).   The  call  would  be   of 
the  form  : 

f  i  x  o  t  (  f  )  ; 
where  f  is  either  0  or  1.  (See  Acoendix  8  for  error  diagnos- 
tics) 

The  association  of  these  flaas  with  the  different  modes 
is  shown  below  in  a  listina  that  indicates  which  flags  are 
effective  in  each  mode.  Note  the  number  assiqneo  to  each 
mode*  as  these  numcers  ar°  used  in  implementing  these  modes 
of  ooeration  on  the  R A M T E K . 


feS 


Mode 
No.  Name 

0  Alphanumeric 

1  T  ransve rse  Oat  a 

2  Raster  Data 

3  Comp lex  Data 

4  G raoh  i  c  Vector 

5  Graoh  i  c  Plot 

6  Graohic  Cartesian 

7  Graohic  Element 


Control  F 1 aqs 
IX  SK  Al,'*  D.V 
YES   YES   YES   YES 


FP 
NO 
NO 
NO 

YES  YES  NO  YES  MO 
YES  YES  NO  NO  YES 
NO 


YES   YES   YES   YES 
YES   YES   YES   YES 


YES   YES 
YES   YES 


N  0   YES 


NO    NO    NO 


YES   YES    NO    NO    NO 


The  control  modes  are  selected  by  use  of  the  "setmode" 
routine.  This  routine  requires  two  parameters/  trie  first  be- 
ing the  number  of  t  *  e  desired  mode  as  indicated  above.  The 
secona  parameter  must  be  either  0  or  1 .  If  zero  is  oassed 
all  control  flags  are  turned  off.  If  one  is  oassea  the  con- 
trol flags  are  left  in  the  state  they  were  in  prior  to  this 
call.  The  call  is  of  the  form  : 

set^odeCa/b) ; 
where  a  is  an  inteoer  value  0  -  7  and  b  is  either   0   or   1. 
(See  Appendix  F5  for  error  diagnostics] 
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V.   VECTOR  GENERAL  DATA  TABLET  INTERFACE 


The  Vector  General  aata  tablet  is  an  electronic  device 
which  allows  the  user  to  sample  the  coordinates  of  its 
tablet-like  surface  (aoorox  17"  by  17 "J.  Ihe  tablet  is  lo- 
cated in  the  Laboratory  aol  is  nosted  ov  the  "A"  side 
PDP-11/50  computer. 

This  tablet  is  interface n  to  the  RAN'TEK  software  s  u  d  - 
Dort  routines  to  crcvide  the  us^r  with  a  valuable  interac- 
tive tool.  To  effectively  utilize  the  data  tablet/  the  user 
must  become  familiar  with  it's  ooeration..  The  following 
steps  will  facilitate  the  familiarization  orocess  : 

(1)  Locate  the  cata  tablet  (for  assistance  see  the 
staff). 

( 2  )  Note  the  0 N - 0 F F  switch  located  on  the  box  con- 
nected to  the  tap  let  surface.  To  use  the  tablet 
the  switch  must  n  e  ON;  when  not  in  use  the  Switch 
should  be  OFF. 

(3)  Locate  the  stylus  (a  pen-like  device  connected 
to  the  controller  ov  a  wire).  On  the  stylus  there 
is  a  olunger  tio  that  may  be  Depressed.  The 
depression  of  this  tio  is  siani  Heart  in  certain 
apo 1  i  c  a  t  i  ons  . 

(4)  Also  notice^  on  the  tablet  eage»  that  there 
are       two   Hants.   One   light   indicates   that  the 
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stylus  is  near  the  tablet  surface   and1   the   other 
indicates  that  the  plunqer  is  depressed. 
(5)  Turn  on  the  tablet  and  witness   the   functions 
of  the  stylus  and  the  reactions  of  the  lights. 

The  data  tablet  interface  allows  the  user  to  interac- 
tively control  the  execution  seauence  of  his  orogram.  TQ 
effectively  utilize  this  tool/  the  user  Should  be  aware  of 
what  the  software  suoport  routines/  designed  for  the  tablet/ 
can  do  for  him.  There  s  re  seven  software  suocort  routines  of 
interest  to  the  user.  An  interactive  tutorial  program  is 
provided  for  the  user's  convenience.  This  program  exercises 
each  of  the  software  suoport  routines  to  give  the  user  a 
feel  for  what  thev  can  do.  To  use  the  tutorial  the  user 
types(at  one  of  the  "  A  "  side   terminals)  : 

LOGIN:  cs2000  c/r 

PASSWORD:  student  c/r 

cd  ramtek  c/r 

vat  an  .  x  c / r 

This  seauence  of  stecs  is  for  the  user  who  is  not  al- 
ready 1 ooged  in  to  u,|v'ix.  If  al  reaav  logged  in/  the  user  need 
only  change  to  the  "ramtek"  Directory,  then  execute  the  tu- 
torial program.  This  would  be  accomplished  by  typing  : 

cd  /usr/cs2000/ramtel<   c/r 

vgtab.x  c/r 

In  eitner  case  the  result  will  oe  that  the  tutorial 
program   will   be   activated.  It  exercises  eacn  of  the  func- 
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tional  routines  in  the  suooort  oackaoe.  Users  are  encouraged 
to  "walk  throuoh"  this  session  prior  to  attempting  to  enaaae 
the  seoarate  tablet  routines.  At  the  comoletion  of  the  ses- 
sion the  UNIX  c  r  o  m  o  t  (%)  will  apoear  on  the  terminal. 

For  reference  Durcoses  and  for  the  user  who  only  needs 
to  be  refresned  on  the  functions  of  the  tablet  support 
routines  a  brief  oescriotion  of  ^  a  c  h  is  c  r  o  v  i  d  e  a  .  The  fol- 
lowing is  a  synoosis  of  the  routines  included  in  the  o  a  c  <  a  a  e 

* 

(l)tabinir()  :  Ccens  the  tablet  and  sets  the  max- 
imum number  of     switches  to  <^S. 

(2)tabdim(txmax/txmin,tvmax/tyminJ  :  Allows  the 
user  to  define  his  own  view  of  the  tablet  by  stat- 
ing the  maximum  and  minimum  values  of  his  co- 
ordinate system. 

(3)cetxy(n)  :  Returns  tne  x  and  y  co-ordinates  of 
a  ooint  on  the  tablet*  as  defined  bv  the  location 
of  the  stylus.  Tne  argument  "n"  allows  the  user  to 
select  whether  or  not  the  t  i  d  neea  be  depressed 
(n=l  oen  must  be  deoressec,  n=0  pen  not 
deo  ressed ) . 

(aJsixoakrC)  :  Defines  a  n  ci  allows  selection  from  a 
standard  set  of  six  loqical  switches  on  the 
tablet. (see  temolafe  1  in  Lao) 

(5)builosw(sw>xhi,xlo/vhi,ylo)  :  Allows  the  user 
to  build  his  own  logical  switch  at  a  location  de- 
fined by  the  users  mout   and   assigns   the   users 
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switch  number  (sw)  to  it. 

Co)getsw()  :  Returns  the  numoer  of  the  valid  logi- 
cal switch  in  w^ich  the  stylus  has  been  depressed 
or  a  -1  if  invalid. 

(7)tabsw(ns)  :  Allows  the  user  to  define  logical 
switches  via  the  tablet  itself  by  picking  the  low 
and  high  ooints  of  each  switch  with  the  stylus. 
The  number  of  switches  aesired  is  indicated  by  the 


For  more  specific  information  on  these  support  routines 
see  Append  i  x  6  . 
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VI.   COLOR  DISPLAYS 


The  RAMTEK  hardware  implements  color  by  combining  red; 
blue  ana  green  in  varying  intensities  to  produce  the  desired 
color.  The  varyina  i n t en s i t i t i es  are  stored  in  the  video 
look-uo  table  C V L T )  for  access  by  the  hardware.  The  G X - 1 0 0 A 
can  generate  Id  levels  of  intensity  for  each  of  the  three 
basic  colors*  which  results  in  4  0  °  6  possible  different  com- 
binations. The  oossicility  of  4  0  °  6  different  colors  does 
not  mean  that  the  user  has  all  4  0^6  availaole  at  once!  The 
RAMTEK  software  allows  for  18  color  tables  of  16  color  en- 
tries each.  This  ^eans  that  the  user  nas  access  to  288 
colors.  The  Gx-IOOA  can  access  only  one  table/  with  16  dis- 
tinct colors*  at  any  given  time. 

For  clarity  the  n  a  r  iware  video  1  o  o  *  -  u  c  table  will  oe 
referred  to  as  the  color  look-uo  table*  The  hardware- 
accessiole  color  loo<-uo  table  can  store  sixteen  (lo) 
seoarate  colors.  This  constraint  is  one  that  the  user  should 
be  aware  of*  but  not  concerned  with;  as  the  software  support 
routines  allow  the  user  to  overcome  this  restriction  auite 
easily*  through  manipulation  of  the  tables. 

The  so f t w a r e  that  orovides  the  color  suooort  for  the 
RAMTEK  allows  toe  user  to  : 

Utilize  predefined  colors. 
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Define  his  own  colors. 

Select  color  sets. 

Select  soecific  colons  within  a  set. 

Interact! vel y  modify  colors. 

Save  color  tables. 

Restore  color  tables. 

Text  and /or  graohics  may  be  d  i  s  o  1  a  y  e  d  in  any  oefined 
color.  The  software  suooorf  allows  the  user  to  define  vir- 
tually any  color  that  he  aesi  res. 

A.   BASIC  USER  GUIDELINES 

The  R A M T E K  software  preloads  a  set  of  color  tables  for 
the  user.  These  tables  orovide  for  the  color  needs  of  most 
beginning  to  intermediate  users. 

The  R  A  M  T  E  K  support  software  o  r  o  v  i  d  e  s  the  user  with  a  set 
of  tools  that  allow  hjt  to  s°l°ct  the  color  to  be  used  for 
disolav.  The  user  must  cause  the  aoorooriate  color  look-up 
table  to  be  initialized  a  n  o  then  he  may  select  from  colors 
within  it.  The  initialization  of  a  oarticular  color  table 
is  accomplished  bv  invoking  a  supoort  function  "colort(n)". 
When  "  c  o  1  o  r  t  (  n  )  "  is  called  the  following  actions  take  dace: 

1.  Colon  table  n  is  loaded. 

2.  All  disolav  imaaes  on  the  screen  are       refreshed 
with  the  new  color  set. 

3.  The  background  color  of  the  screen   is   set   to 
entry  zero  of  the  new  table. 
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Once  the  user  has  loaded  a  particular  color  table,  he 
has  sixteen  colors  available  for  disolay.  To  then  select  a 
color  from  t  n  e  tacle  to  be  used  for  display/  the  system  sup- 
port function  "color(n)"  is  utilized.  All  images  displayed 
subsequently  will  be  oi  solaved  in  color  "n"  of  the  current 
color  table. 


Of  the  eighteen  tables  established  by  the  so' ft  ware,  nine 
are  filled  with  predefined  colors  ana  nine  are  blank.  Four 
of  these  taoles  art*  protected  from  user  modification  (0-3). 
These  orotected  tables  *"  a  y  oe  utilized  out  not  modified.  The 
nine  predefined  tables  provide  a  sufficiently  large  color 
selection  for  most  users;  however,  there  are  a  total  of 
eighteen  (16)  color  tables  should  the  user  recuire  more 
flexibility.  The  nine  blank  tables  must  be  defined  or  filled 
by  the  user  if  he  desires  to  use  them  (see  the  exol anat ion 
in  Advanced  Color  ;V  e  t  h  o  d  s  )  .  The  colors  present  in  the  nine 
predefined  color  taoles  are  listed  below: 


COLOR  TABLE 
0 
1 

d 
3 
a 
5 
6 
7 
8 


COLOR 
shades  of  grey 
sr,  ades  of  blue 
sh  ades  of  green 
sh  ades  o  f  red 
m  i  xed 
mixed 
mixed 
mi  xed 
shades  of  yellow 
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The  RAMTEK  user  software  allows  the  viewinq  of  any  color 
table  in  the  system.  For  the  user  to  look  at  a  particular 
color  table  he  need  only  issue  the  aoprooriate  system  call. 
Two  different  types  of  display  are  available,  an  expanded 
and  a  brief  display.  The  brief  disolav  rr a y  be  selected  by 
the  system  function  "dsovcthl (n)";  the  expanded  by 
"diso(n)". 

The  brief  display  causes  color  table  "n"  to  be  displayed 
as  a  column  of  ooxes  in  the  individual  colors  of  color  table 
" n".  The  exoanded  display  gives  the  user  not  only  a  column 
of  boxes,  out  lines  and  alohanumerics  in  each  color,  as  well 
as  the  octal  code  that  achieves  that  color  combination. 

The  best  way  for  the  user  to  oecome  familiar  with  the 
concepts  and  support  functions  introouceo  is  by  using  them. 
Three  executable  programs  have  been  orovided  for  the  users 
convenience. 

1.   PROGRAM  I 

Tnis  program  is  oesianeo  to  demonstrate  the  brief 
color  table  disolav,  loading  of  a  color  table,  select ina  a 
particular  color  entry  from  a  color  taole,  ana  the  result  of 
a  particular  color  selection.  The  program  will  first 
display  co'or  table  seven  (7)  in  the  cripf  format,  then  de- 
lay for  six  (o)  seconds  and  display  a  box  in  color  four  of 
color  table  seven.  The  user  may  tyoe  the  orogram  in  himself 
or   use   the   c s 2 0 0 0  file  where  it  exists  in  oofh  the  source 
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form  and  an  executable  f  o  r  m . 

a.  To  use  the  c  s  2  0  0  0  file  type  * 
LOGIN;  c  s  2 0 0  0  c / r 
PASSWORD:  student  c/r 
co    r am  t  e  k  c/r 
b.To  list  the  or0qram: 

list  -c  ol.c  c/r 
c.To  execute  the  program: 

p  1  .  x  c/r 
a.  For*  the  user  who  aesires  to  input*  compile/  and  exe- 
cute  the   proaraTi  himself  a  listing  of  the  source  code 
is  p  ro v  i  ded . 
ma  i  n  (  ) 

{ramtekO;  //initialize  RAMTEK 
erased;  //erase  the  screen 
dspy c t b 1 ( 7 ) ;  //disolav  color  table  7 
colort (7) ;  //select  color  table  7 
c o 1 o r ( H  )  ;  //select  entry  4 
sleeo(b);  //delay  b  seconds 
b1ock(50. 0,50. 0,75. 0,35.0);  //draw  block 
> 
The  routine   "bloc*"   will   be   explained   in   a   later 
chapter;  it  should  not  concern  the  user  at  this  staae. 

2  .   PROGRAM  2 

This  examole  is  desianed  to  introduce   the   user   to 
the  exoandea  format  for  displaying  a  color  table  and  the  ef- 
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feet  on  the  screen  imaae  of  losaina  a  new  color  table.  Par- 
ticularly the  example  aisnlays  color  table  six  (6)  in  t^e 
expanded  format,  delays  six  Co)  seconds  ana  then  loads  color 
table  five  (5).  The  user  should  note  that  when  the  new  color 
taole  is  loaded  it  is  effectively  displayed*  Out  the  text 
still  indicates  that  it  is  color  table  six  (h).  This 
highlights  the  fact  that  all  of  the  information  displayed 
changes  color  out  the  information  itself  remains  unchangea. 
a.  To  use  c  s2000  : 

LOGIN:  cs2000  c/r 
PA3S/-0P0:  student  c/r 
cd  ram t  ek  c/r 
b.To  list  the  prcaram: 

list  -c  p<?  .  c 
c.To  execute  the  crooram: 

d2  .  x  c/r 
d.  To  inout  the  c  r  o  a  r  a  m  the  following  listing   is   p  r  o  - 
v  i  ded  : 

ma  i  n  (  ) 
{ 

ramtek  J;  //initialize 
erased;  //erese  screen 
colort (o);  //load  color  taole 
a  i  s  d ( 6 ) ;  //disolav  color  taole  b 
sleeo(6);  //delay  for  o  seconds 
c  o I o  r  t ( 7 ) ;  //load  new  color  table 
} 
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3.   PROGRAM  3 

This  example  is  designed  to  emohasize  the  effect  of 
the  display  color  selection.  Color  table  s  e  v  e  n  (  7  )  will  oe 
loaded  then  a  box  displayed  in  color  3  of  that  table.  A 
short  delay  will  occur,  then  anotner  box  will  be  displayed 
in  color  four  (4)  of  that  table.  The  dsoyctbl  option  is  used 
to  allow  the  user  to  verify  the  results, 
a.  To  use  c  s<?00  0  : 

LOGIN:  cs2000  c/r 
PASSWORD:  student  c/r 
ca  rantek  c/r 
b.To  list  the  oroaram: 

list  -C  o3.c  c/r 
c.To  execute  the  crogram: 

o3 . x  c/r 
d.  The  program  listing  follows: 
TainO 

{ramtekO;   //initialize  ramtek 

colort (7);  //select  color  table  7 

dscyctb1(7);  //display  color  table  7 

color(3);  //select  color  3 

/  *  d  r  a  w  box  in  color  3  * / 

bl cck  (50.0, 75.0,95.0,5.0)  ; 

sleep(6);  //delay  6  sec 

colorCU);  //select  color  4 

bl  ock  (65.  0,  o0  .0  ,  80.  0  ,  20  .  0  )  ',     //craw  box  color  a 

} 
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Tne  user  should  now  he  capable  of  writing  programs 
that  utilize  basic  color  manioulation  techniques.  There  are 
more  complex  and  soohi  st  icated  options  that  are  covered  in 
the  next  sec  t  i  on  . 

8.   ADVANCED  COLOR  METhOOS 

The  basics  for  color  manipulation  recui  re  little  effort 
on  the  part  of  the  user.  Since  the  more  advanced  user  may 
need  to  solve  a  more  complex  n  r  o  h  1  e  m  ,  the  R A M T E K  software 
has  been  designed  to  assist  the  user  and  simplify  these 
sometimes  comolicated  tasks. 

The  hiaher  level  user-oriented  suooort  routines  are  pri- 
marily to  allow  the  user  to  modifv  existing  color  tables, 
build  new  color  tables?  save  a  grouo  of  color  tables/  ana 
restore  to  an  active  status  old  color  tables. 

1.   MODIFYING  COLOR  TABLES 

The  modification  of  the  18  color  tables  may  be  ac- 
complished by  utilizina  the  data  tablet  or  the  R A M T E K  key- 
board. Each  of  these  techniaues  will  be  discussed  so  that 
the  user  may  intelligently  select  the  aporopriate  one. 

a.   DATA  TABLET  METHODS 

The  system  software  that  supports  data  tablet 
color  manipulation  is  comoact  and  fast;  this  will  be  an  ad- 
vantage to  the  user  who  recui  res  on-line  color  table  manipu- 
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lation  .  In  order  to  execute  this  suoport  package  the  user 
issues  a  call  of  the  form  :  tabcclorO  ;  .  The  system  will 
then  prompt  for  the  requireo  inputs  to  alter  and/or  build 
color  tables. 

The  user-oriented  routine  "taocolorO"  offers 
one  of  two  options  :  building  an  entire  table  or  changing  an 
existing  table.  The  tablet  is  vieweo  in  this  application  as 
per  template  2.  in  the  Lab  .  Once  in  execution  the  program  is 
tutorial  in  nature  ana  will  prompt  tne  user  for  required  in- 
puts. A  sa^Dle  session  is  orovided  to  familiarize  the  user 
with  color  manipulation  via  the  aata  tablet. 

( 1 )   PROGRAM  4 

This  exercise  is  aesigned  tc  familiarize 
the  user  with  the  techniques  used  by  the  data  taolet  color 
manipulation  function. 

(l)To  use  t  h  «=>  c  s  2  0  0  0  *  i  1  e  tvce  : 
LOGIn:  CS20U0  c/r 
PASSWORD:  student 
cd  ramtek  c/r 
(2)To  list  the  source  code: 

list  -c  o4.c  c/r 
(  3  )  T  o  execute  tne  o  r  o  i  r  a  m  : 

pu  .  x  c/r 
(U)For  the  user  who  wishes  to   inout   the   source   code 
himself   a   listing  is  orovided.   This  program  initial- 
izes the  R A M T E K ,     erases  the  screen  ana  then  calls   into 
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action  the  data  tablet  color  manipulation  package  . 
ma i  n  (  ) 

{ramtekO;  //initialize 

tadinitC);  //initialize  tablet 

eraseO?  //erase  screen 

tabcolorO;  //call  V  .  G .  taolet  routine 

erased; 

> 

b.   KEYBOARD  METHODS 

The  ouroose  of  this  interactive  program  is  to 
allow  the  user  to  see  an. 3  modifv  the  color  1  o  o  k  -  u  o  tables 
while  seateo  at  the  R  A  '^  T  E  K  kevboaro  .  This  extensive 
software  oackaae  is  very  large  and  should  not  oe  used  in- 
discriminately. Tt  is  hirjhly  recommenaed  that  it  be  used 
only  to  build  a  set  of  color  tables*  tnen  save  these  tables 
to  be  loaaea  into  the  users  oroauct ion  program  at  a  later 
time  (see  saving  color  tables). 

For  a  comcle^e  exDlanaticn  of  this  oction  see 
the  description  of  i  n  t  e  r  (  )  in  aocendix  B .  If  the  user  is 
interestea  in  utilizing  this  ootion  he  snould  execute  the 
following  oroaram  to  get  an  aooreciation  for  it's  capabili- 
ties. 

f  1  )   PROGRAM  5 

Tnis  examole  program  initializes  the  RA^TEK 
and  calls  the  interactive  color  manipulation  routine. 
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(a)  To  use  the  cs2000  file  tyDe  : 
LOGIN:  cs2000  c/r 
PASSWORD:  student  c/r 
cd  r am  t  e*  c/r 
(b)To  list  the  o  r  o  g  r  a  m  : 

list  - c  dS.c  c/r 
(c)To  execute  the  orogram: 

d5  .  x  c/r 
( d )  Program  listing: 
ma  i  n ( ) 

{ramtekO;  //initialize 

eraseC);  //erase  the  screen 

interC);  //call  color  m  a  n  i  o  .  routine 

> 

The  utilization  of  inter()  vice  tabcolorO 
will  result  in  the  user  orogram  being  *b  9  4  8  cytes  larger.  The 
size  of  orograms  being  a  consideration  in  software  design 
implies  that  inter()  should  be  used  selectively.  There  sre 
specific  acplications  that  reauire  it's  use  ana  it  will  oer- 
fornn  well  in  these  aop  1  i  c  a  t  i  ens  . 

c.   MANUAL  COLOR  LOADING 

The  system  Drovides  for  the  user  the  capability 
to  orogrammatically  load  a  particular  color  table  as  an  ar- 
ray of  entries.  This  crocess  is  more  cumbersome  ana  less 
flexible  than  the  other  two  color  manipulation  techniques. 
The  programmatic  loading  of  a  color  table  by  the  user  forces 
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him  to  preselect  colors  and  manually  provide  the  mechanism 
for  loadinq  ,  out  in  small  uncomplicated  apolications  af- 
fords the  user  a  feasible  solution  to  Ms  immediate  problem. 

The  programmatic  loadinq  of  a  color  table  is  a 
two  steo  process.  The  first  stec  in  the  crocess  is  to  con- 
struct an  array  in  his  program  that  defines  the  selected 
color  intensities.  This  definition  of  colors  is  accomplished 
by  first  declarinq  an  array  of  16  elements*  since  this  is 
the  number  of  elements  in  a  color  taole  .  The  array  must 
then  be  given  the  aocropriate  color  intensities  by  a  system 
software  routine  call  fo  t  r  i  p  1  e  (  )  (see  Appendix  B,  tripleO/ 
for  specifics).  The  rricle  routine  returns  a  coded  value 
that  represents  the  appropriate  color  mix.  Once  the  array 
has  the  aoorooriate  ceded  value  it  is  then  p  rog  ramrrat  i  c  a  1  1  y 
loaded  into  the  master  array  of  color  tables  by  calling  the 
system  routine  "  c  1  r  t  b 1  ( t  f  a  )  "  (see  clrtbl*  Appendix  B),  where 
"t"  is  the  numoer  of  the  color  table  to  be  replaced  and  "a" 
is  the  name  of  the  color  taole  holding  the  cooeo  values. 

This  orocedure  may  seem  complicated  ann  is  prob- 
ably better  illustrated  by  an  example.  The  user  is  en- 
couraged to  execute  the  example  program  to  experience  the 
process . 

(1)   PROGRAM  6 

This  program  ta^es  a  certain  predefined  set 
of   color   mixes   ana   builds   color  table  9  .  Once  the  color 
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table  has  been  bui  H»  it  is  then  displayed  for  the   user   to 

view.   In   addition   to  d  i  s  o  1  a  v  i  n  g  the  color  tables  a  set  of 

intersecting  lines   are   drawn   that   intersect   at   virtual 

screen   co-ordinates  (5.0*5.0).  The  lines  are  drawn  in  color 

y  of  color  table  9,     the  one  just  built. 

(a)  To  use  the  c S 2 0 0 0  file  tyoe: 

LOGIN:  cs2000  c/r 

PASSWORD;  student  c/r 

Cd     rarr>te'<     c/r 

(b)To     list     the    program: 

list     -c    c  6 .  c    c/r 

lc)To  execute  the  proaram: 

pb  .  x  c/r 

(d)  Program  listing: 

int  a  [  1  6  ]  ;  //declare  array 
ma  i  n  (  ) 

{ ram t  e* ( ) J   / /  initialize  ramtek 

/*  set  color  intensities  into  array  * / 

aI0]=tpip1eU5,15,15);  //white 

atl]=tpicle(15,0,0); 

a[2]=tpiple(0,15,0); 

a  [  3 1  =  t  r  i  c  1  e  (  0  ,  0  ,  1  S  )  ; 

a  UJ=tpip1e(3, 14,2) ; 

af5]=triple(8,l5,0); 

a  [61  =r ric 1 e(8,0,0 ) ; 

a  (71 =trip1e(0,8,0); 

a  C  8  1  =  t  r  i  c  1  e  (  0  ,  0  ,  8  )  ; 

a[9]=triole(8,8,0); 

aU0]=tPio1e(0,8,8); 

atll]=trio1e(8,0,8); 

atl2]=triDle(10, 10,10); 

aU3]=tPio1e(4,9,l); 

atia]=tPiple(5,0,5); 

a[lS)=triolefQ,l,15); 

clptbl(<5,a);  //load  master  array 

dspyctbl(9);  //display  color  table  9 

colortC^);  c  o  1  o  r  (  4  )  ;  //select  color 

scpeenCO. 0,0.0, 10.0, 10.0);  //dimension  screen 

ax i s ( 5  .  0 , 5  .  0  )  :  //draw  axis 

> 
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The  user,  h  e  v  i  n  a  now  executea  the  sugaested 
sample  orograms,  should  have  a  good  appreciation  for  how  to 
create  ana  manipulate  color  tables.  If  more  in-depth  infor- 
mation is  required*  the  user  is  encourageo  to  research 
References  1  and  3  for  the  specific  hardware  and  support 
des  i  qn  . 

2.   SAVING  COLOP  TAbLES 

As  mentioned  earlier*  the  system  color  tables  are 
initialized  each  time  a  user  begins  a  session.  These  colors 
may  oe  altereo  b v  the  methods  oescribeo  aoove.  The  aciHty 
to  save  the  current  state  of  all  color  tables  for  use  at  a 
later  time  not  only  enhances  the  users  capabilities  but  is 
an  absolute  must  for  production  programs  that  reguire  cer- 
tain color  sets.  The  user  will  certainly  appreciate  the 
problem  if  he  considers  the  case  where  he  has  defined  a 
large  number  of  specific  color  sets  for  distinct  applica- 
tions using  "tabcolorO"  a  n  g  /  o  r  "  i  n  t  e  r  (  )  "  /  and  has  no  way  to 
save  them.  Without  the  color  savina  option*  in  oraer  for  the 
user  to  continue  to  use  a  specific  set  of  defined  colors  in 
reoeatea  runs  of  the  same  program,  he  must  reconstruct  them 
each  time. 

In  utilizing  the  save  color  option  the  user  must   be 
aware  of  two  routines: 
savcl r(  )  ; 
r  e  s  c  1  r  (  )  ; 
The  routine  "savcl r()"  saves  the  entire   color   arrav   in   a 
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file  called  "savcol".  Tne  routine  "resclrO"  restores  the 
file  "savcol"  into  t^e  active  master  color  array  so  that  the 
user  may  reinstate  a  specific  set  of  color  tables. 
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VII.   ALPHANUMERIC  N'ODE 


A.   INTRODUCTION 

This  mode  is  usee)  for  oisolaving  alphanumeric  (ASCII) 
characters  on  the  P  A  M  T  E  r^  screen.  The  basis  of  this  mode  is 
the  transformation  of  the  individual  ASCII  characters  into  a 
dot  matrix  by  means  of  a  character  font.  The  font  defines 
this  matrix  to  be  five  screen  elements  by  seven  screen  lines 
in  dimension.  This  character  natrix  is  actually  disolayed 
within  a  seven  element  by  twelve  line  matrix/  to  nrovide 
separation  of  characters.  This  is  illustrated  in  Appendix  B 
0f  the  RAMTEK  Gx-100  Programming  Manual  [11  . 

The  ASCII  characters  are  disolayed  startino  at  the 
Current  Operating  positicn  (COP)  from  left  to  right  on  the 
same  line.  If  more  tran  91  characters  are  written  en  one 
line*  they  will  "wrap  around"  and  over  write  the  peg  inning 
characters  on  that  same  line.  (If  the  optional  "double- 
width"  size  characters  are  used/  the  maximum  number  per  line 
is  45.  ) 

The  aoolicaPle  oots  (pixels)  in  the  character  matrix  (as 
defined  by  the  character  font)  will  appear  in  the  current 
selected  color/  while  the  remainder  of  the  matrix  will  be 
"filled  in"  with  the  current  background  color. 
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B.   BASIC  USER  GUIDELINES 

As  mentioned  earlier  in  this  manual*  the  software  sud- 
port  packaae  for  the  RAMTEK  is  contained  within  the  UNIX 
file  system,  in  the  form  of  a  library  of  suoroutines  written 
in  the  'C'  programming  lamuaqe.  These  routines  are  accessed 
(via  any  of  the  terminals  on  the  "A"  system)  by  comoilinq  a 
user-createci  'C  program  containing  references  to  functions 
that  reside  in  that  library.  Thp  soecial  snell  command  for 
compiling  a  oroqram  that  calls  routines  from  the  RAMTEK  li- 
brary is  called  "ramte<"*  and  neeas  only  be  passed  the  name 
of  the  file  to  be  comoiled. 
Such  a  command  woulo  be  of  the  form  : 

ramtek   filename,  c 
(note  that  the  file  ^ust     be  of  tyce  ".c") 

The  first  qraphics  routine  that  must  be  called  from 
within  the  user's  program  is*  in  every  case;  the  one  that  is 
also  named  "ramtek" .  (This  should  not  oe  confused  with  the 
shell  command  above)  This  routine  ooers  the  device*  erases 
the  screen*  and  estanl isnes  user  access  to  it.  The  call 
shoula  aopear  as  follows  : 

r  a  m  t  e  k  (  )  ; 

To  place  the  RAMTEK  device  in  the  Alphanumeric  Mode*  the 
user  may  utilize  the  "setmode"  routine*  with  a  call  of  the 
form  : 

s  e  t  m  o  o  e  (  0  *  0  )  ; 
(Note  :  the  Alphanumeric  mode  has  oeen  defined   to   be   mode 
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"0"?  the  second  parameter  of  " 0 "  turns  off  anv  previousl v- 
selectea  control  flaasJ  a  "1"  in  this  position  would 
preserve  these  flags.) 

Although  some  aisclav  routines  will  automatically  set 
the.  prooer  mooe,  it  is  gooo  or  act  ice  to  include  this  "set- 
mode"  call  in  user  programs. 

The  user  is  now  readv  to  select  the  area  on  the  screen 
in  which  he  cesires  alohanumeric  data  to  be  displayed.  A 
guick  review  of  the  initial  ieina  "ra^tekC  ) "  routine  would 
reveal  that  the  virtual  screen  has  been  dimensioned  to  100  X 
100,  ana  the  Current  Operating  Position  (COP)  is  located  in 
the  lower  left  corner  (coorcinates  0,0).  If  these  dimensions 
are  not  favorable*  the  user  may  select  his  own  with  a  call 
to  the  "screen"  routine  of  the  form  : 

SCreen(xmin/ymin,xmax,ymax)  '* 
where  the  oarameters  are     real  numpers. 

In  any  case»  before  a  call  to  one  of  the  display 
routines*  trie  user  should  confirm  the  location  of  the  COP 
(the  point  at  which  tha  disolav  will  begin).  The  COP  may  be 
re-established  bv  a  call  to 

Strtxy(x/y); 
where  x  and  y  are   real   numbers   for   the   desired   virtual 
screen  coordinates. 

For  the  simple  aoplication  of  displaying  a  single  char- 
acter on  trie  screen,  the  orocedure  called  "lttr(ch,size)"  is 
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used.  The  call  is  of  the  form  : 

lttrC'x',size); 

where  the  character  desired  to  be  output  is  enclosed  in  sin- 
gle quotes  or  its  ASCII  code  is  given  without  Quotes.  The 
size  is  passed  as  either  1  (normal  size)  or  2  (double 
width).  All  control  bits  or  flans  remain  as  previously  set. 
The  character  is  disolayed  at  the  existing  COP.  No  line  feed 
occurs*  hut  the  x-value  is  incremented  cv  7  real  screen  ele- 
ments as  a  result  of  the  cutout.  (The  COP  moves  to  the  right 
7  pixels.) 

The  most  straight-forward  aooroach  to  displaying   a  set 

of  ASCII  characters/  such  as  a  bloc<  of  text/  is  with  a  call 

to  the  routine  "texto" /  which  reouires  b  parameters,  in  ord- 
er, as  fellows  : 

1.  The  address  of  an  array  of  oointers  to  the  text?  The 
oointer  arra\  snould  ^ave  been  oeclareo  as  pointers  to 
an  array  of  va r i ao 1 e- 1 eno t h  character  strings.  The  ac- 
tual array  of  character  strinas  should  be  initialized 
following  the  array  declaration  by  enclosing  eacn 
string  in  douole  auotes  and  seoarating  tnem  by  commas. 
The  last  element  should  be  a  zero,  witnout  auotes. 
(see  examole  below) 

2.  The  number  of  the  desired  color  table  (an  integer 
value  :  4  -  17) 

3.  The  numoer  of  the  oesirea  entry  from  that  color  table 
(integer  value  :  1  -  15) 
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U .  An  inteaer  value  (1  or  2)  to  denote  desired  character 
size.  If  this  parameter  has  value  1  the  characters 
are  disolayed  in  nerval  size?  if  it  has  value  ct  the 
characters  are    cisolaved  in  douole  width  size. 

5  .  An  integer  value  ( 0  or  1)  to  aisable/enable  the  a  o  d  i  - 
tive  write  cacao ilitv.  If  this  parameter  has  value  1/ 
the  corresDonding  text  will  be  written  "on  too  of" 
(ie>  in  adoiticn  to  -  -  nof  in  replacement  of)  the  ex- 
isting screen  image.  If  the  value  is  0,  the  oesired 
text  will  reolace  the  contents  of  the  refresh  memory 
that  exists  at  tKe  soecified  locations. 

1.   PROGRAM  7 

The  execution  of  this  oroaram  will  oi  sol  ay  the  de- 
clared block  of  text  in  double-width  cnaracter  size;  start- 
ing at  the  virtual  screen  coordinates  (25. 0/75.0),  The  char- 
acters will  Oe  written  in  tne  color  specified  by  color  entry 
5  of  color  taole  7  *  and  will  reolace  any  data  previously 
written  tnere. 

This  o  r  o  g  r  a  m  would  normally  be  comoiled  using  the 
'C'  compiler  in  conjunction  with  the  system  library  of  R  A  iv'  - 
TEK  subroutines*  via  the  followinq  command  :  "ramtek 
filename.c"/  where  filename  is  the  name  of  tne  user  file 
containing  the  program.  However*  this  example  is  available 
in  executable  form  in  rne  "  c  s  2  0  0  0  -  ramtek"  directory  on  the 
"A"  system.  (sp»  Chanter  II*  Operating  Instructions) 
a.  To  use  the  c s 2 0 0 0  directory  : 
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LOGIN:  csaOOO   c/r 
PASSWORD:  stuoent   c/r 
cd  r am  t  e  k   c/r 

b.  To  list  the  proqram  : 

list  -c  d7.c    c/r 

c.  To  execute  the  program  : 

d7  .  x  c/r 

d .  The  listing  follows  : 


char  *txtlT  1         /*  declare  and  initialize  the   */ 
{ " W hat  you  see  "/    / *  cointer  array  ana  text    * / 
"    is  what  you  get  " , 
"  when  you  call  ...."> 

/ 
T  E  <  T  0 


0 

>;  . 

i  nt  c  t 
i  n  t  co 
i  n  t  sz 
i  nt  wo 
m  a  i  n  ( 
{  ram 
st  r 

texto(txtlrCtablrCo1i#szlswol)# 
} 


abl   7; 
11   5; 
l  2) 
l   o; 
) 

tek(  )  ; 

txy(25. 0,75.0)  ; 


/ *  color  table  7. */ 

/ *  color  entry  5  *  / 

/*  double  width  characters  * / 

/*  no  write-over  */ 

/*  open  the  device   * / 
/*  set  starting  point  */ 


C.   ADVANCED  ^EThOHS 

After  a  review  of  "texto"  in  Appendix  9,  the  user  should 
realize  that  its  advantages  lie  in  simplicity  ana  generali- 
ty. In  oroer  to  perform  more  complicated  alphanumeric 
display  tasks,  the  user  may  wish  to  oroceea  to  a  more  de- 
tailed level  of  operations. 

Further  analysis  of  "texto"  would  reveal  that  it  actual- 
ly  makes   a   series  of  calls  to  lower-level  routines.  These 
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routines  may*  of  course;  be  employed  individually. 

As  before/  the  first  steo  in  displaying  characters  is  to 
insure  that  the  system  is  in  the  Alphanumeric  moae.  This  is 
accomplished  by  calling  the  routine 

set  rrode  (  a  /  b  )  ; 
passina  a  zero  value  to  parameter  a.  Parameter   h   must   re- 
ceive  either  a       0  to  turn  off  all  control  flags*  or  a  1  to 
leave  control  flags  as  Dresently  set. 

Again*  if  the  user  wishes  to  change  the  dimensions  of 
the  virtual  screen,  he  may  call  the  procedure 

screen(xmin,ymin*xmax,ymax)  * 
and  pass  the  minimum  and  maximum  values  of  the  desired  coor- 
dinate  system.   This   procedure  leaves  the  COP  at  the  lower 
left  comer  of  the  screen. 

In  oraer  to  select  a  oesired  working  color  table*  the 
user  may  call 

c  o  1  o  r  t  (  t  )  ; 
Dassina  the  number  of  the  table  to  the  oarameter  t.  Then  the 
appropriate  display  color  entry  is  selected  by  a  call  to 

color(e) J 
where  e  is  the  entry  number  *  r  o  m  the  selected  table. 

To  estaolish  a  new  COP  for  a  particular  display*  the 
proceou  re 

Strtxy(x*y); 
is  utilized  with  the  starting  X  and  Y  coordinates  (as  shown 
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before)  beinq  passed  as  real  Daraireters. 

The  size  of  the  characters  displayed  may  be  ordered  by  a 
call  to 

size(s) » 
with  s  beino  either  1  or  ?.     If  s  is  passed  a   value   of   1, 
the   characters  will  be  displayed  in  normal  size?  if  a  value 
of  2  is  passed*  they  will  be  displayed  in  double  width  size. 

The  selection  (or  deselection)  of  the  'additive  write' 
feature  (ie»  the  intention  to  'add  to'  rather  than  reolace 
the  Dresent  screen  i^aqe)  is  relayed  to  the  system  by  a  call 
to 

w  r  i  t  on  (  w  )  ', 
with  w  receiving  a  1  if  write-over  is  desired  or  a  0  if  not. 

The  actual  next-level  disolay  routine  that  is  called 
upon  hy  "texto"  is  "strout(s)"»  *here  s  is  a  oointer  to  a 
single  strino  of  less  than  100  characters.  For  example*  if 
the  user  had  the  following  declaration  in  his  orogram  : 

char  strinct  1  {"This  is  a  string."}; 
then  a  call  of  the  form 

strout(strina); 
would  display  that  sentence  on  the  screen.  It  should  be  not- 
ed here  that  after  a  call  to  "strout"/  an  automatic  line 
feed/carriage  return  is  performed,  leaving  the  COP  on  the 
next  available  line  and  at  the  same  element  position  as  the 
prev  i  ous  COP  . 
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To  carry  this  discussion  one  step  lower  in  the  struc- 
ture;  we  ooint  out  that  "stfour"  actually  counts  the  nunber 
of  bytes  in  the  character  string  and  passes  this  number/ 
along  with  the  aadress  of  the  string,  to  the  routine 
"data(nare>  length)"  .  This  routine  is  also  available  to  the 
user  if  he  is  certain  of  the  number  of  bytes  in  his  charac- 
ter string  and  ooes  not  attempt  to  oass  a  string  that  is  too 
long.  As  an  example,  with  the  same  "cnar  string"  declaration 
as  above;  the  user  could  write 

da  t  a ( s  t  r  i  nq ,  17)  ; 
to  accomplish   the   same   task   as   "strout(string);".   This 
routine   also   leaves  the  CUP  on  the  next  line  ana  same  ele- 
ment as  the  previous  COP. 

After  some  error  checking  and  settinq  control  bits,  "aa- 
ta"  goes  one  steD  lower  by  making  a  system  call  to  the 
"dumo"  routine^  which  transmits  the  raw  oata  (according  to 
the  byte  count)  to  the  RAN'TEK  instruction  buffer  for  in- 
terpretation and  rnsplay. 

By  similar  inspection,  we  find  that  "size"  actually 
utilizes  a  lower-level  routine  called  "dblwid"  to  set  the 
appropriate  control  bits  ana  "dump"  this  data  to  the  PAMTEK 
buffer. 

The  "dump"  routine  exists  at  about  the  lowest  level  of 
the  user  interface.  To  directly  utilize  this  routine,  the 
user  is  aaviseo  to  aain  a  oreater  familiarity  with  the  "RAM- 
TEK  GX-1U0  Programming  Manual"   [11. 
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1  .   PROGRAM  8 

This  s  a  m  o  1  e  program  will  demonstrate  the  use  of  the 
alphanumeric  display  routines  mentioned  above.  It  is  avail- 
able for  viewing  in  the  "cs2000  -  ramtek"  directory.  Its 
execution  will  result  in  the  declare"!  string  of  alphanumeric 
characters  being  d  i  s  o  1  a  y  e  d  ^  in  tandem/  at  three  successive 
locations  on  the  screen,  and  in  three  different  colors.  Note 
that  the  second  oisolay  call  in  each  instance  is  not  preced- 
ed by  a  call  to  "strtxy".  This  demonstrates  the  location  of 
the  COP  after  callino  either  of  these  display  routines. 

a.  To  use  the  c  S  <2  0  0  0  directory  : 

LOGIN:  cs20  0  0   c/r 
PASSWORD:  student   c/r 
ca  ramtek   c/r 

b.  To  list  the  program  : 

list  -c  Db.c    c/r 

c.  To  execute  the  oroars^  : 

p8  .x    c/r 

d.  The  listing  follows  : 


char  strinaU   ("This  is  a  strino."}; 

//string  declaration 

mainO 

{ramtekO;     //  ooen  the  nevice 
screen(0.0,u.O, 10.0, 10.fi);   //dimension  screen 
color  t ( 7  j ;    //  select  color  table  7 
color(l);    //  select  color  1 
setfiode(OfQ);   //  select  alphanumeric  moae 
size(2);     //  select  double- width  size 
strtxy(0.5r9.0);   //set  startinq  Doint  (COP) 
strout  (string)  ;     //  a  i  Splay  the  string 
da t a ( s t r i ng ,  I  7 ) ;   //  disDlay  same  string 
sleep(2);     //  pause  2    seconds 
color (u);    //  cnanae  color 
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strtxy (3.0/6.0) ;  //  chanae  COP 

strout (string)  ;  //  repeat  display 

data ( st rinq, 17)  ;  //   " 
s 1 eep ( I )  ; 

color(7)  ;   //  change  color  again 

strtxv(5. 5/3.0);  / /  chanae  COP  again 

da t a ( s t r i nq , 1 7 ) ;  //  reoeat  aisolay 

strout (st rinq);  //  repeat  display 
} 

This  same  display  could  be  achieved  by  the  following 
more  concise  program/  better  utilizing  so^e  of  the  features 
of  the  ' C'  programming  language.  It  also  exists  in  execut- 
able form  in  the  " C  s  2  0  0  0  -  r  a  m  t  e  <  "  directory  discussed  in 
Chapter  II. 

2.   PROGRAM  9 
Note  the  initialization  of  variables  in   declaration   state- 
ments/  and  the  use  of  assignment  statement's  and  expressions 
as   parameters   in   the   procedure   calls   for   "color"   and 
"strtxy".  Once  again  : 

a.  To  use  the  c s 2 0 0 0  directory  : 
LOGIN:  cs2000   c/r 
PASSWORD:  stucent   c/r 
cd  ramtek   c/r 
P.  To  list  the  crcqram  : 
list  -c  r9 . c    c/r 

c.  To  execute  the  program  : 

p9  .  x     c/r 

d.  The  listina  follows  : 


Char  strinnf]   {"This  is  a  stnna."}; 

float  stx  -5.0;    //  initialize  starting  X  value 

f  1  o  a  t  s  t  y  9  .  0  ;    /  /       "  "       Y 

mai  n  ( ) 


97 


{ i  or  i  ; 
ram t  ek  (  )  ; 

screenCO. 0,0. 0,10. 0,10. 0)7 
set mode (0,0) ;   size  (2); 
co I  or t ( 7  )  ; 
f  o  p  ( i  =  o ;  i  <  = 
(colorCi+l); 
strtxyC (  s  t  x 
st rout  (strinq) ; 
dataCstrina, 17); 
sleep(2) ; 
> 
} 


6 ;  i  =  i  +  3 ) 

=  st x+2.5) , (sty 


-  i  ) ) ; 


OR 


VIII.   TRANSVERSE  DATA  MODE 


This  mode  is  desianpo  to  allow  the  user  to  define  and 
draw  irregular  images  in  the  vertical  olane  (8  elements 
wide)  of  the  RAMTE*.  These  figures  snould  be  in  a  single 
color;  as  t  •">  e  facility  for  changing  colors  while  processing 
an  image  does  not  exist  while  in  the  transverse  data  mode. 

The  user  fust  gain  a  superficial  understanding  of  how 
the  R  A  m  T  E  K  processes  his  data  in  this  mode  to  oe  able  to 
use  the  mode  effectively.  The  bit  pattern  of  a  set  of  user 
defined  data  words  (bytes)  describes  the  image  to  be 
displayed.  The  user  will  define  data  words  or  bytes;  reqara- 
less  of  which  he  chooses*  the  R A M T E K  interprets  the  data 
byte  by  Dyte  Ca  oyte  consists  of  eight  bits).  The  bit  oat- 
tern  of  each  oyte  turns  ON  or  OFF  individual  pixels  on  the 
RA'^IEK  screen. 

An  octal  numper  in  the  C  programming  lanauage  [31  is 
denoted  by  a  leading  zero.  The  octal  form  of  numbers  will  be 
used  exclusively  in  oreparino  transverse  data*  since  it  is 
simpler.  If  the  user  was  to  define  the  data  word  "x"  as  "x 
=  0  1  5  0  2  <£  (x  is  of  type  intecer)  then  it's  oit  by  bit 
representation  for  the  system  would  be:  0001101000010  010. 
The  R A M T E K  would  further  decompose  this  woro  into  two  data 
bytes   (0001  1010  and  00010010).  The  data  bytes  are    then  pro- 
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cessed  Dy  the  RAMTEK  sequential  1 v>  beginning  at  the  user  de- 
fined starting  point  (see  "strtxy").  The  eight  cixels  to  the 
right  of  this  point  are  interpreted  as  either  ON  or  OFF 
depenoina  on  the  value  .of  it's  corresponding  bit  in  the  data 
byte.  A  one  indicates  that  the  o  i  x  e  1  is  to  be  turned  ON; 
zero  indicates  the  OFF  state.  Each  consecutive  byte  is  then 
written  immediately  below  the  last  one  until  all  are  pro- 
cessed (see  "data"). 

A.   BASIC  USSR  GUIDELINES 

Two  very  likely  acolications  for  the  transverse  aata 
mode  are  definition  and  display  of  soecial  symbols  ana  ir- 
regular vertical  images.  Software  support  routines  are  pro- 
vided to  allow  the  user  to  perform  these  actions. 

1.   SPFCI4L  SYMBOLS 

A  common  use  of  the  transverse  data  mode  would  be  to 
define  special  symbols  that  are  not  provided  in  the  stan- 
dard character  set.  Fcr  e  x  a  m  o  1  e  >  the  user  may  desire  to 
display  the  lowercase  Greek  letter  alpha.  By  defining  this 
letter  in  a  linear  arrav  of  lenath  six  (words) >  and  calling 
the  system  support  function  "symbol  f  s  y )  "  /  where  " s  y "  is  the 
array  name/  the  user  rr  a  y  oisolay  this  special  symbol  auite 
easi  1 y  . 

To  define  a  special  character  the  user  should  first 
draw   a  matrix  (8  bv  12)  and  develop  a  gracnical  representa- 
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tion  of  that"  cudracter.  For  e  x  anr>  p  I  e  »  the  lowercase  t»  r  e  e  k  al- 


pha «  o  u  1  ■  "i  n  e  : 
bYTt 
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1  U 
1  ) 

:  ^ 
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The  next  steo  for  the  user  would  be  to  transform  >■  S  i  s 
graphic  representation  into  a  data  representation  t  n  a  *  can 
he  utilized  Cy  the  support  package.  Transforming  the  g^ac -  - 
cal  representation  of  the  lowercase  Greek  alpha  into  a  v ' - 
able  data  representation  is  accomplished  as  follows: 

a. Transform   the   graphical   view    into    the    binary 
rep  resent  a  t  i  on . 

(-  represents  a  blank  ;  *  a  dotj 
HYU     GRAPHIC  P.  I  NARY 

I     00000000 

i  0  0  0  0  0  0  0  0 

3     oooooooo 

u     -  -  * *  -  0  0  1  0  0  U  1  0 

5     _*_*-*.-  0  1 0  1 0 1 0  0 

e    *  —  *  —         loooiooo 

/     -*„*-*--  01010  100 

h    --* — *-         ooioooio 
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q     00000000 

!0    oooooooo 

i]     oooooooo 

12         oooooooo 

b.  Marry  oairs  of  bytes  into  words.  This  is  done 
sequentially  from  the  beginning. 

BYTES  BINARY  NUMBER 

I  and  2  0000000000000000 
3  ano  a  U000000000100010 
5  and  6  010  1010  01000  1000 
7  and  8  0 1 0 1 0 1 0 0 0 0  1  0 0 0  1  0 
9  and  10  0000  000000000000 

II  and  12   0000000000000000 

These  six  words/  recresented  in  their  cinary  number 
form,  provide  the  most  basic  data  form  of  the  lowercase 
Greek  aloha. 

c.  Transform  the  binary  rec re  sen t a t i on s  into  octal 
numbers  for  processing.  Tni  s  Dinary  to  octal  transfor- 
mation is  done  from  right  to  left.  Each  binary  word  is 
divided  into  5  grouos  of  three  birary  d  i  g  i  t  s  t  with  one 
binarv  digit  left  over.  The  position  of  the  ones  in 
these  grou pines  recresent  powers  of  the  number  two.  Trie 
leftmost  diait  represents  t  *  o  sauared  when  a  one  is  in 
this  location.  The  enter  diait  ,  when  one*  represents 
two  to  the  'first  Dower.  The  rightmost  digit  represents 
a  one  (two  to  the  zero  power).  Sum  the  numbers  in  each 
grouD  of  three  to  yield  one  octal  oioit. 
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EX: 

010  1O10O00  1  000  10 

0   101   010   0  00   100   010 

0   5    2.    0    a    2 

Thus  the  octal  reoresentaHon  would  be:  0052042. 
a.  An  octal  wore,  as  previously  stated/  is  denoted  by  a 
leading  zero.  The  followina  six  octal  numbers  represent 
the  lowercase  Greek  alpha  oescrioed  above: 

0  0  0  0  0  0  0 

00000a2 

005221U 

00520a? 

0  0  0  0  0  0  0 

0  0  0  0  0  0  0 

Now  that  the  user  has  an  octal  number  to  aefine  the 
special  svmnol/  he  mav  generate  that  symbol  by  calling  the 
system  support  routine  "symbol (sy)"i  *^ere  "sy"  is  tne  name 
of  the  user  defined  arrav  containing  the  octal  definition  of 
the  symbol.  The  user  shoulo  verify  that  ^he  octal  code  list- 
ed above  is  correct. 

a.   PROGRAM  10 

Tnis  prooram  is  desianed  to  show  the   user   the 

mechanics   of   building  a  special  symbol  ana  displaying  that 

symbol  on  the  R A M T E K .  The   Greek   lowercase  alpha   will   be 
displayed  in  stanaard  size  ana  double  width. 
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(l)To  use  cs2000  type*. 

LOGIN:  cs2000  c/r 

PASSWORD:  stuaent  c/r 

cd  ram t  ek  c/r 
(2)To  list  the  orogram; 

list  - C  plO.c  c/r 
(3)To  execute  tfie  proaram: 

c  I  0  .  x  c/r 

(tJ)Program  List  ino: 

/♦DECLARE  ARRAY*/ 
int  alDhalo]  {0000000,0000042, 
0052210, 0052042, 

0000000,0000000}; 

mai  n  C ) 

{ra^tekO;  //initialize 

strtxyC 50. 0,50.0);  //set  COP 

colort(7);  //select  color  taole 

co 1 o  r ( 2 ) ;  //color  2 

symbol Cal pha ) ;  //output  alpha 

ablwidCl),  //set  louhle  wiot h 

stPtxvC50. 0,30.0);  //estaolish  COP 

svtoo 1 (aloha); 

} 

2.   IRREGOLAR  VERTICAL  IMAGES 

It  is  auite  o  1  a  u  s  i  n  1  e  to  consider  the  use  of  the 
transverse  data  -node  to  define  irregular  images.  The  system 
software  supports  the  d  e  S  i  q  n  ana  display  of  columns  of  in- 
formation via  the  function  "tdata(tptr,by,ex,1y)M ,  where 
"totr"  is  the  na<ve  0  f  the  array  (pointer),  "by"  is  the 
numoer  of  bytes  to  be  output*  "ex"  is  the  desireo  starting  x 
value,  and  "ly"  is  the  desirec  starting  y  value. 

The  user  might  desire  to  develop  a  set  of  oversized 
parentheses   for  a  special  application.  This  is  accomplished 


104 


by  first  aef ininq  the  imaoe  as  niscussed  in  the  previous 
sect  ion,  then  vie  " t  a  a  t  a "  creating  the  display.  Suppose  that 
the  user  has  defined  his  virtual  screen  to  be  100  py  100/ 
with  (0,0)  in  the  lower  left  corner.  Perhaps  he  has  use  for 
a  set  of  parentheses  that  encompass  2  0%  of  the  screen  or, 
more  specifically,  uh  real  screen  lines  (.2  *  240  =  48).  He 
must  then  define  4  8  bytes  oer  image  to  accomplish  this  tas^. 
The  definition  of  the  data  is  as  oiscusseo  previously. 

a.   PP0G«4V1  11 

This  procram  shows  the  user  the  definition  of   a 
set   of   parentheses,   as  discussed  adov3,  and  how  to  create 
the  images  on  the  screen  of  the  pA"'TEK. 
C 1 )  T  c  use  c  s  2 0  0  0  t  v  o  e  : 
LOGIN:  cs20  0  0  c/r 
PASSWORD:  student  c/r 
ca  ramtek  c/r 
(2)To  list  the  crogram: 

list  -c  rll.c  c/r 
(3)To  execute  the  oronram: 

d  1  1  .  x  c/r 
(^)Program  listing: 

i  n  r  1 c a  r  e  n  ( 2 4 ]  {0000401,0  0  00403,0  001403, 

0003006,0003014,0  0  06014, 
0014030,0014060,0030060, 
0060140,006030  0,0140300, 
0140300,014014  0,0060140, 
0030060,0030  0  30,0014030, 
0  0  0  6  0  14,0  0 06006,0 0 03006, 
0001403, 0001401, 0000401}; 

i  n  t  r  p  a  r  e  n  f  2 4 ]  {010020  0,0100300,014030  0, 

0  0  6  0  14  0,0060060,0030060, 
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0014030,0014014,0006014, 
0003006,0003003,0001403, 
0001403,0001406,0003006, 
0006014,0006030,0014030, 
0030060,0030140,0060140, 
0140300,0140200,0100200}; 
ma  i n C ) 

{  r amt  ek  (  )  ;  //initialize 

c  o 1 o  r  t ( 7 ) ;  color(2);  //colons 

tdataClDaren, 48, 40. 0,60.0) ;  //output 

tdataCrcaren, 48, 60. 0,60.0);  //output 

} 

The  function  "taata"  allows  the   user   to   paint 

portions   (or   all)   of   the  screen  by  adjusting  to  the  next 

column  when  screen  overflow  occurs.  The  user  n  e  e  a  not   wcrrv 

about  aoing  off  the  bottom  of  the  screen. 

b .   PROGRAM  12 

This  proaram  s  n  o  «  s  the  reset  action  of  the  func- 
tion "taata".  Data  is  oassea  to  the  routine  that  is  much  too 
long  to  be  aisplaveo  in  a  sinale  column,  thus  it   oaints   to 
the  right.  The  image  crawn  is  a  dotteo  line. 
(  1  )  T  o  use  c  s  2  0  0  0  type: 
LOGI^1:  cs20  0  0  c/r 
PASSWORD:  student  c/r 
co  ramte*  c/r 
C2)To  list  the  program: 

list  -c  p\  2  .c    c/r 
( 3 ) T o  execute  t  h  e  croaram: 

P  1  2 . x  c/r 
(4)Prooram  listing: 
i  n  t  t  e  s  t  1 3  0  0 )  ; 

r>a  i  n  (  ) 

lint  i;  ramtek();  //initialize 
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/initialize  array*/ 

for ( i  =0; i  <30U  7 i  +t) 

test  [i]  =  01; 

color t (7} ;  c  o I o  r ( 2  )  ;  //colors 

t da taCtest , 600, 10.0/40.0); 

} 

The  user  should  now  possess  tne  skills  required 
for  processina  the  vast  majority  of  his  transverse  data  ap- 
plications. The  next  section  will  discuss  some  of  the 
specifics  of  the  mode  for  more  advanced  applications. 

B.   ADVANCED  METHODS 

The  user  who  desires  to  execute  sc"e  orocess  that  re- 
quires more  flexibility  J:nan  provided  in  the  previous  sec- 
tion will  have  to  drop  down  one  level  in  the  support  package 
to  the  more  fundamental  functions  for  processing  transverse 
data.  The  most  fundamental  function  in  the  support  pacioqe, 
in  relation  to  transverse  data*  is  "data(name,bytes)".  The 
"data"  routine  simolv  sends  raw  data  to  the  P A M T E K  from  the 
arrav  "name"  for  the  specified  number  of  "bytes". 

The  user  must/  at  this  level/  oe  resconsib'e  for  setting 
the  mode  Csee  " setniode"  J  »  establishing  the  current  operating 
point  Csee"strtxy"),  ana  orovidina  his  own  oroorammatic  con- 
trol. The  data  definition  process  is  the  same  as  discussed 
in  the  bASIC  USER  GUIDELINES  section. 

The  control  flaqs  that  are  applicable  in  the  transverse 
data  mode  are : 

INDEXED  ADDRESSING 
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REVERSE  BACKGROUND 
ADDITIVE  /jRITE 
DOUBLE  WIDTH 

The  user  must  select  all  of  his  flags  and  provide  the 
mechanism  for  their  imolemenf at  ion,  Comclicated  transverse 
data  applications  reouire  much  attention  to  detail  for  suc- 
cess. For  more  scecifics  the  user  is  encouraged  to  peruse 
the  R  A  M  T  E  K  Programming  Manual   f  1  )  ,  in  the  Lab. 
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IX.   RASTER  DATA  MODE 


The  Raster  data  mode/  except  for  the  direction  of  the 
writing/  is  like  the  Transverse  data  mooe.  The  Raster  data 
mode  writes  across  the  screen  vice  down  the  screen.  The 
utility  of  this  rnoae  is  that  it  allows  the  user  to  effi- 
ciently draw  irregular  imaaes  of  various  shapes  and  sizes. 

The  very  nature  of  user  aoclications  for  this  tyce  of 
Drocessing  nictates  that  it  be  utilized  at  a  lower  level 
than  previous  data  xcces.  The  user  m  a  v  define  and  draw  any 
image  that  he  can  conceive.  The  user  must ^  however/  provide 
all  programmatic  control  himself/  as  nothing  is  assumed. 

The  applicable  control  flags  in  this  mode  are  '. 
INDEXED  ADDRESSING  (s^e"index") 
REVERSE  BACKGROUND  (  see  "b ka rod" ) 
ADDITIVE  mRITE  Csee"wr i ton" ) 

DOUBLE'/.- IDT  h  (see"size"J 

The  user  should  recall  from  previous  chapters  that  to 
place  the  R  A  m  T  E  K  in  a  particular  mode  of  operation  the  "set- 
mode"  software  support  function  is  utilized.  To  olace  the 
RA^TEK  in  the  Raster  cata  mode  a  call  of  the  form 

setmone(e!/y); 
would  ne  issued.  The  argument   "y"   determines   if   previous 
flags  are       to  oe  saved.  If  "v"  is  a  one  (1)/  then  all  prior 
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flags  are  saved;  if  zero  (0),  then  all  flags   are   reset   to 
the  default  values. 

The  user  who  is  unfamiliar  with  the  aenerat ion  of  the 
octal  data  codes  that  define  an  image  shoulc  review  the  sec- 
tion on  Transverse  oata.  The  octal  data  form  is  recommended 
for  it's  simplicity. 

The  software  suncort  function  "Data"  is  used  to  tran- 
sport the  raw  data  tc  the  R A M T E K  for  display,  a  call  of  the 
form 

d  a  t  a  (  x  ,  v  )  ; 
causes  "y"  bytes  of  data  to  be  passed  to  the  R A N' T £ K  from  ar- 
ray "x"  . 

The  following  san-ole  orogram  is  provided  to  assist  the 
user  in  developing  his  expertise  in  the  use  of  the  faster 
data  moae : 

A.   PROGRAM  13 

This  program  is  o  e  s  i  a  n  e  d  to  show  the  user  a  specific  use 
of  the  Raster  data  mode.  The  orociram  draws  a  set  of  inter- 
secting lines  much  like  a  aria  system  or  data  record.  The 
versatility  of  the  Paster  aata  mode  is  only  restricted  cy 
the  users  imagination. 

1.  To  use  c s 2 0 0 0  tyoe: 
LOGIN:  cs2000  c/r 
PASSWORD:  student  c/r 


1  in 


cd  ramtek  c  /  r 
2. To  list  the  proqram: 

list  -c  d 1 3  .  c 
3. To  execute  the  program: 

o  1  3  .  x  c/  r 

4 .  P  rogram  Listing  : 

/  *  Define  a  horizontal  line  * / 

1 n  [  1  8 ]  {0177777,0177777,0177777,0  177777,0  177777, 
0177777,0177777,0177777,0177777,0177777, 
0  177777,0  177777,0  177777,0  177777,0177777, 
0177777,0177777,0  177777}; 
/•Define  vertical  seaments*/ 
d  i  v  [  1  6  1  {Q1400  0  3,G3,03,u3,03,03,0  3,03,03,03,u3,0  3, 

03,03,03,03,03,03} ; 
ma  i  n (  ) 

{int  i,j;  float  s  x  ,  s  y  ;  //oeclare  variables 

sx  =  160.0;  Sy  =  lbO.O; 

ramtekC);  //initialize  system 

colort(7);  //establish  color  table 

se t mode ( 2 , 0  )  ;  //establish  raster  mode 

c  o  1  o  r  (  2  )  ;  //select  color 

screen( 0.0, 0.0,640. 0,240.0);  //dimension  screen 

/* 

OUTSIDE  LCQP  CONTROL 

*/ 

f  o  r  (  j  =  0  ;  j  <  1  2  ;  j  +  +  ) 

< s t r t x y ( s x , sy ) ;  //estadlish  start  point 

sy  =  sv  -  l;  //decrement  y 

oata(ln,36); 

/•INSIDE  LOOP  */ 

for(i=0;i<16;if+) 

{data(div,36)  //send  aata 
sv  =  sy  -  1  ; 
} 
s  y  =  s  y  t  1  ; 
} 
data ( 1 n, 36)  ; 
> 

The  user  should  now  oossess  the  reauirea  skills  to 
develoo  his  own  soecial  imaoes  as  reouired.  For  further  in- 
formation on  this  mode  the  user  is  encouraaed  to  read  the 
RAMTEK  Proarammers  Manual   f  1  1   in  the  Lab. 


1  1  1 


X.   COMPLEX  DATA  MODE 


This  mode  writes  data  to  the  P  A  M  T  E  K  screen  in  the  same 
manner  as  the  faster  data  moae»  exceot  that  it  allows  the 
user  to  define  the  color  of  each  oixel  as  it  is  painted. 
This  third  dimension  of  color  does  have  some  overhead  asso- 
ciated with  it/  in  that  now  the  user  must  define  the  color. 
The  color  definition  reauires  four  (4)  bits  oer  pixel  vice 
one  (1)  bit  oer  pixel  in  tKe  other  two  aata  modes.  The  im- 
pact on  the  user  is  thai-  where  one  data  wcro  describes  six- 
teen (16)  pixels  in  either  Raster  or  Transverse  aata/  it 
only  aescribes  four  C 4 )  pixels  in  the  Complex  data  mode. 

The  obvious  benefit  of  this  mode  is  that  r  he  color  of 
images  may  be  modified  on  a  pixel  by  pixel  basis.  The  four 
bits  required  to  define  a  color  allow  the  user  to  address 
any  one  o*  fifteen  (15)  colors  in  the  current  color  look-up 
taole.  The  user  must  construct  his  data  words  now  using 
binary  coded  decimal  as  an  added  steo  prior  to  converting  to 
oc t  a  1  . 

The  color  definition  of  each  oixel  must  oe  done  by  the 
user/  then  passed  to  tne  software  supoort  o roqramma t i ca 1 1 y . 
This  color  definition  reouires  the  use  of  4-bit  binary 
groups  (called  binary  cooed  decimal).  These  groups  are  com- 
bined into  lo-oit  binary  patterns/  then  converted  (ov   3-bit 
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grouos)  to  octal.  Suppose  the  user  wishes  to  define  a  word 
that  selects  four  (4)  oixels  and  colors  them  according  to 
the  colors  one/ four  f seven  ana  eleven  of  the  current  color 
look-up  t  a  o  1  e .  To  accomplish  this  task  he  must  convert  the 
desired  color  entries  (1,4,7,11)  to  binary  codeo  decimal 
form  as  shown  below: 

DECIMAL         BINARY  CODED  DECIMAL 
1  0  0  0  1 

a  oioo 

7  0111 

11  1011 

The  binary  cooed  decimal  numbers  are  then  combined  into  one 
binary  word.  For  the  aoove  example  this  numoer  would  be: 

0  0  0  I  0  1  0  0  0  1  1  1  1  0  1  1 
This  binary  number  must  then  be  transformed  into  an  octal 
representation  as  discussed  in  the  chanter  on  Transverse  da- 
ta. Tne  octal  representation  for  this  examole  would  be 
0  0 1 £1 7  5  .  The  user  must  perform  this  data  transformation  him- 
self. 

Once  the  data  words  are  orooerly  defined?  the  user  need 
only  place  the  R A M T E K  in  the  Complex  mode  with  a  call  of  the 
form 

s  e  t  m  o  d  e  (  3  ,  f  )  ; 
where  "f"  determines  if  orevicus  control   flags  are       to   oe 
saved   or   destroyed  <  f  =  1  save  ;  f  =  0  destroy).   Having  esta- 
blished the  mode  of  operation  the  information  is  now   passed 
to  the  R A i^i T E K  with  a  call  of  the  form 
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dat a (x - 1 n  )  } 

which  causes  "n"  bvtes  of  raw  data  to  be  passed  to  the   R  A  M  - 
TEK  from  the  array  "x". 


The   following   control   flaqs  are       applicable 
operation  in  the  Complex  model 
INDEXED  ADDRESSING 
REVEnSE  background 
DOUBLEwIDTH 


while 


The  folio wine  samole  program  is  provided  to  assist  the 
user  in  Developing  expertise  in  the  use  of  the  Complex  data 
mode  : 

A.   PROGRAM  14 

This  program  is  designed  to  demonstrate  the  Complex  data 
mode.  Its  execution  causes  the  entire  display  screen  to  be 
painted  with  alternating  bands  of  the  first  seven  colors  in 
color  table  seven.  Tne  screen  is  then  oartially  erased  and  a 
triangle  with  similar  properties  is  displayed. 
1.  To  use  c s 2 0 0 0  tyce: 

login:  csaooo  c/r 

PASSWORD:  student  c/r 

cd  ramtek  c/r 
2 . 1 o  list  p  rogr am  : 

list  -c  p 1 4  .  c    c/r 
3. To  execute  nrogram: 

o  I  ^  .  x  c/r 
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4 .  P  roqram  1  i  s  t  i  nq 


i  nt 
ma  i 


1 
n( 
H 

r 
s 

/ 
f 


Clbl 

) 

nt  i 

amt  e 

e  t  mo 

*  I  M  I 

o  r  (  i 

{) 

1 

1 

1 


] ;  //cec } are    array 

,  }  ,  k  'r  float  sx/Sv; 
k();  //in  it  system 
de(3,0) ;  //establ i  sn 

TIA|_IZE  AR9AY  1  */ 
=  0  ;  i  < 1 6  1  ;  i  =  l  +  14) 


mode 


[ 
[ 
( 

[ 

I  [ 
1  [ 
1  [ 


)   =1  f i  +1]  =0073567; 

+  2)  =1  n  +3]  +00b3i4b; 
+  4J  =1  H  +51 =0052525; 
+  fa  J  =  1  U+7]=0042104; 

+  8 )  r 1   [i+9]=0031463; 

+  10  1=1  ['i +113=0021042; 
+  121=1  li+13J=001042i; 


(0.0,0.0,640.0,240.0);  //aimension  screen 
(7);  //select  color  table 
0;  sx  =  0.0;  Sy  =  0.0; 


sc reen 

co 1 o  r t 

k  =  32 

/* 

PAINT  SCREEN 

*/ 

for(i=0;i<24  0;i++) 

(strtxy(sx,sy); 
data( 1  ,  k  )  ; 
s  y  =  s  y  +  1  ; 

} 

ASE  PORTION  OF 

(40.0,10.0,600 

fao.o;  sv  =  20.0; 
oo; 


ER 
se 


/* 
t  er 
sx 

k  = 
/* 

DRAW  TRIANGLE 
/* 

f  o  r  (  i  =  0  ;  i  <  I  0  0  ;  i  +  +  ) 
{Strtxy(sx,sy)  / 

data  (  1  ,  <  ) ; 

k  =  k  - 1  ; 

s  x  =  s  x  +  1  ; 

s  y  =  s  y  +  1  ; 

> 


SCREEN  */ 
0,230.0); 
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XI.   GRAPHIC  VECTOR  ^ODE 


A.   INTRODUCTION 

The  Graohic  Vector  Mode  is  used  primarily  to  draw  lines 
or  vectors  between  user-defined  end  points.  It  is  relative- 
ly simple  to  use  an  j;  oy  its  nature;  fits  many  applications. 
The  user  must  be  aware  t  h  a  t  except  in  vertical  or  horizontal 
lines;  a  noticeable  quantization  erro^  or  "stair-casino"  ef- 
fect will  appear.  This  condition  is  causea  by  the  low  line 
resolution  (c^O  addressable)  versus  hiqh  element  resolution 
(640)  of  the  system  and  by  the  very  nature  of  the  raster 
scan  aevice. 

8.   BASIC  USER  GUIDELINES 

To  put  the  RAiSTEK  device  into  this  mode  reouires  a  call 
of  the  form 

setmodeC^/0)  ." 
where  4  is  the  defined  number  for  this  mode  and  0   indicates 
that   all   control  flags  are    to  be  turned  OFF.  If  the  second 
parameter  was  1/  all  flans  would  be  left  as  set  previously. 

The  first  two  routines  presented  celow  actually  set  the 
proper  mode  themselves  Cbv  call  inn  "setmode"  internally); 
although,  as  previously  mentioned/  the  use  of  "setmooe"  in 
the   user's   program   is  considered  standard  practice.  These 


1  16 


are  "vector"  and  "plot  In".  The  first  accents  as  parameters 
two  sets  of  virtual  screen  coordinate  oairs  and  draws  a  line 
between  the  two  poinds  that  thev  define.  It's  call  would  ap- 
pear as  follows  : 

vector(xl  ,  y  1  ,  x2  /  y2)  't 

The  second  accents  two  eoual  length  arrays  of  real 
numbers  and  an  integer  value  to  denote  that  length.  It  then 
plots  the  Doints  described  by  the  co r respond i na  x,y  values 
and  connects  each  successive  point  with  a  line  from  the  pre- 
vious one.  Thus  if  two  arrays  were  Declared  and  initialized 
as  follows  : 

float  p  x  [n ]   {xl,x2/x3,..../xn>; 

float  pytnl   <ylfv2*v3,..../yn}; 
then  a  subroutine  call  of  the  form 

plotln(px,py,n); 
would  correlate  the  respective  values  from   the   two   arrays 
and  olot  the  points  with  connecting  lines. 

Another  routine  which  actually  sets  the  proper  mode  by 
itself  is  one  wnicn  might  be  utilized  in  conjunction  with 
"plotln".  This  is  the  "axis"  routine.  As  implied  by  its 
name*  this  subroutine  draws  a  coordinate  axis  on  the  screen 
accoroino  to  the  two  real  numpers  it  accepts  as  parameters. 
It  would  be  called  as  follows  : 

a  x  i  s  C  x  ,  y  )  ; 
where  x  and  y  represent  the  desired   virtual   screen   values 
for  the  intersection  of  tne  axes. 
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C.   ADVANCED  METHODS 

At  the  next  level  flown  in  the  structure  of  the  software* 
there  are  several  routines  which  are  hiahly  functional  in 
this  system.  The  first  of  thesp  is  the  procedure  for  estab- 
lishing a  new  Current  Ooerat ina  Position  (COP).  To  reiterate 
its  usage*  a  call  of  the  form 

S  t  r  t  x  y  (  x  f  y  )  ; 
where  x  and  v  are    real  numbers*  would  establish  the   COP   at 
that   virtual  screen  location.  From  t  n  e  r  e  *  a  vector  could  be 
drawn  to  another  ooint  bv  utilizing  either   the   "ooint"   or 
"oointr"  routines  in  this  mode.   A  call  of  the  forrr 

ooint  (  x  /  v  )  ; 
with  the  parameters  recr°senring  the  x  ana  y  values  for   tne 
desired   point*   woulo   draw   a   vector  from  the  COP  to  that 
ooint  ana  establish  the  C  U  P  at  the  new   point.   (unless   the 
fixed  poinf  flag  was  ON) 

In  similar  circumstances/  a  call  to 

oointr(dx*dv); 
would  draw  a  vector  from  the  COP  to  a   coi^t   "relative"   to 
the   COP   as   determined   by   the   "chance"  values  passed  as 
parameters.  Here  a  q  a  i  n  the  COP  would  be  established   at   the 
newly  calculated  ooint  unless  the  fixed  ooint  flag  was  ON. 

As  mentioned  in  "Control  !v1ooes  and  Flags"  (Chao  I V  )  *  the 
fixed  point  flag  is  turned  ON  and  OFF  by  a  call  to 

f  i  x  o  t  (  f  ) ; 
where  f  is  given  the  value  1  to  turn   ON   the   flag   or   tne 
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value  0  to  turn  OFF  the  flag. 

If  this  flag  is  ON,  a  call  to  "strtxy"  establishes  a 
fixed  ooint  from  which  all  suosequent  vectors  will  be  drawn 
by  calls  to  "point"  or  "oointr" .  In  effect/  it  freezes  the 
COP  until  the  occurrence  of  another  "strtxy"  command  or  un- 
til the  flag  is  tumec  OFF. 

The  user  snould  be  aware  that  each  time  the  fixed  ooint 
flag  is  turned  0'NJ,  after  havinq  been  OFF,  a  new  "strtxy" 
call  is  REQUIRED  to  establish  the  desirea  fixea  position. 
The  flag  cannot  be  simcly  toqglea  ON  ana  OFF  amiast  a  series 
of  "ooint"  ana/or  "cointr"  calls,  without  erratic  results. 

Other  flags  which  affect  the  ooerat ion  of  subroutines  in 
this  mode  are  the  Indexed  Addressing  flag,  which  was  ex- 
plained in  "Virtual  Screen  Ancressing",  ana  the  Reverse 
Background  flag/  discussea  in  "Control  vioaes  and  Flags". 

1.   PROGRAM  15 

The  samnle  crcgrem  listed  below  is  available  in  the 
"  c  s  2  0  0  0  -  ramtek"  directory  to  illustrate  a  variety  of  the 
described  routines.  Selective  rielays  have  been  emoloyea  in 
the  program  to  allow  the  viewer  to  notice  the  following  : 

1.  the  change  of  Dackground  color   when   " c o 1 o r t ( 7 ) "   is 
executed   (because  the  "  r  a  m  t  e  k  "  routine  initializes  to 
color  tanle  0); 
<?.  the  efficiency  of  "olotln"  in  drawing  the  first  three 
sines  of  the  star,* 
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3 .  the  use  of  "oointr"  to  draw  the  fourth  side   relative 

to  the  t h  i  rd; 
4 •  the  use  of  "vector"  to  draw  the  final  side; 
5.  the  use  of  the  fixed  ooint  m  e  t  n  o  a  for   drawing   lines 

from   the   center   to   the  extreme  points  of  the  star, 

with  "ooint"  ana  "oointr". 

The  user  should  realize  that  "olotln"  establishes 
its  own  initial  C  ^  P  at  the  first  ooint  ana  leaves  the  COP 
located  at  the  last  ooint  that  it  olots.  he  shoula  also  Oe 
aware  of  the  location  of  the  COP  before  and  after  each  of 
the  other  disolav  routines  are  called.  Notice  that  "strtxy" 
is  used  only  once  -~  immediately  after  turning  on  the  fixed 
ooi  n t  flag. 

The  figure  disolayed  by  this  crogram  illustrates 
dramatically  tne  'stair-casing'  effect  that  occurs  when 
drawing  lines  at  various  anqles  on  the  screen.  The  user  may 
also  notice  that  a  horizontal  line  is  slightly  'fatter'  than 
a  vertical  one  cue  to  the  afore-mentioned  difference  between 
line  resolution  and  element  resolution  in  this  system. 

a.  To  use  tne  c s 2 0 0 0  directory  : 

LOGIN:  cs20  0  0   c/r 
PASSWORD:  stucent    c/r 
cd  ram t  e  k   c/r 

b.  To  list  the  crcqram  : 

list  -c  olS.c    c/r 
c/r 
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c.  To    execute    the    orogram     : 

D  1  5  .  x  c  /  r 

d .  The    listing    follows    : 


float  pxtaj  { - a . 

f 1  oat  py  in)     {-6. 
i  nt  pn  4 ; 
mainO 
(int  i ; 

ram t  ek (  )  ; 

sc  reen (-10.0/ 

si eep(2) ; 

c  o  1  o  r  t  (  7  )  ; 

si eep(2) ; 

c  o  1  o  r  (  5  )  ; 

set-Tiode(4/0); 

pi ot 1 n (px  >oy , 

si eeo(2) ; 

poi  nt  r (  1  3.  0/ 0 

s 1 eep(2) ; 

vector(6.5^. 

s  1  e  e  p  (  2  )  ; 

color(l); 

f  i  x  o  t  ( i ) ; 

strtxy(  0.0/0. 
pointr(b.5/2. 
s 1 eec (2  )  ; 
f  o  r  (  i  =  0  ;  i  <  4  ;  i 
{do  i  n  t  (dx  f i 

sl eeoT2) ; 
} 
> 


0/  0  .0/ a  .0/ -b.5> ;     //declare  arrav 
0,6.5,-6.0,2-0};     // 
//declare  array  length 


//ocen  the  device 
-10.0,10.0/10.0);   //set  screen  size 

//cause 

//select  color  taole  7 
//cause 

//select  color  5 

//set  graphic  vector  mode 
en);     //plot  the  array  points 

/ /cause 
.0);      //draw  line  relative  to  COP 

//pause 
0,-4.0,-6.0);    //draw  with  "vector" 
/ /cause 

//select  color  1 
//turn  0>vj  fixed  point  flag 
0);     //set  startina  point  (COP) 
0);   //draw  first  line  relative  to  COP 

/ /cause 
++)  //draw  remaining  points 

1  ,py  [i]  ) ;      //   from  f  i  xed  COP 
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XII.   GRAPHIC  PLOT  MODE 


A.   INTRODUCTION 

The  primary  function  of  the  graphic  plot  mode  is  to  gen- 
erate the  display  of  a  histogram  style  plot.  In  effect/ 
this  means  to  shade  or  color  the  area  cetween  a  selected  x 
axis  and  a  line  defined  dv  user-generated  coints.  This  shad- 
ing is  actually  accomplished  ov  drawing  a  series  of  vertical 
lines  adjacent  to  each  other.  The  software  that  accomplishes 
this  is  built  around  a  R  A  M  T  E  K  hardware  feature  in  this  mode 
which  automatically  increments  the  element  address  by  one 
after  each  line  is  drawn.  Thus  after  the  starting  element 
has  been  estaclished*  each  successive  element  (proceeding 
left  to  right)  is  inoivinually  addressed/  until  the  final 
point  is  reached.  As  e  a  c  n  element  is  addressee/  a  vertical 
line  is  drawn  from  a  ore-selected  co^^on  line  or  'x  axis'  to 
the  proper  line  address  or  y  value.  The  most  obvious  appli- 
cation is  o lot  ting  a  'function'  and  shedina  the  area  between 
that  'function'  and  a  certain  x  axis. 
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B.   BASIC  USER  GUIDELINES 

To  select  the  orachic  dot  moae  the  user  should  make  a 
subroutine  call  of  the  form 

setmodeCSf  0  )  ; 
where  5  is  the  defineo  number  for  this  mode  and  0   indicates 
that   all  control  flags  are  to  be  turned  OFF.  If  a  1  were  in 
this  position/  all"  control  flags  would  be  left  as  set  previ- 
ous 1  v . 

This  mode  is>  in  effect/  implemented  in  one  routine 
called  "oloth".  Tnis  routine  clots  a  set  of  *,y  coordinate 
points/  as  did  "olefin"  in  the  previous  c  h  a  o  t  e  r  /  ana  then 
shades  the  area  'under  the  curve'  as  described  above.  As 
with  "plotln"/  the  "oloth"  routine  requires  two  equal  length 
arravs  of  real  numbers  that  describe  the  'function'  to  be 
plotted/  and  an  integer  value  that  denotes  the  lenqth  of  tne 
arrays.  It  also  requires/  as  a  fourth  oarameter/  the  real  y 
value  ( represent i no  the  x  axis)  from  which  the  clot  should 
start.  Thus  a  call  to  this  routine  would  oe  as  follows  ' 

oloth(px/cy/n/base) ; 
where  "px"  and"cv"  are  the  names  of  the  arrays/  "n"   is   the 
length   of  the  arravs/  and  "base"  is  the  desired  base  of  the 
histogram  clot.  For  crocer  results/  the  x  values  must  oe  ar- 
ranged in  ascenoing  order  in  the  array. 
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1.   PROGRAM  16 

This  samole  Qrogram,  available  for  execution  in  the 
"  c  s  2  0  0  0  -  ramtek"  directoryf  will  illustrate  the  histogram 
style  plot  achieved  ny  "oloth".  prior  to  plotting  the  histo- 
gram* a  set  of  axes*  that  will  coincide  with  the  center  of 
the  plot*  are  oositionecl  on  the  screen.  The  user  should  note 
that  the  histogram  overlaos  and  wipes  out  these  axes  in  the 
areas  that  are  c  o  m  rr  o  n  to  the  two  displays.  I  f  the  "axis" 
call  had  been  n laced  after  the  "  ploth"  call/  this  condition 
would  be  reversed.  Tne  routine  " c 1 o  t I n "  is  also  called  with 
the  same  data  to  ocint  out  tne  relationship  between  these 
two  routines.  (Note  :  The  "setmode"  calls  could  nave  been 
omitted*  since  both  "oloth"  and  "olotln"  set  their  own  r  e  - 
guireo  mooes  internally.) 

a.  To  use  the  c  s  2  0  0  0  a i rectory  : 

LOGIN:  cs2000    c/r 

PASSWORD:  stucent    c/r 

cd  ramtek    c/r 
O.  To  list  tne  orcqram  : 

list  -c  0 16. C      c/r 

c/r 

c.  To  execute  tne  program  : 

o  1  b  .  x    c/r 

d.  The  listing  follows  : 

float  p x [ 4 0 ]  {3.0,3.1,3.2,3.3,3.4,3.5*3.6,3.7,3.8,3-9, 

a.  o,a.i, a. 2, 4. 3, a. 4, 4. 5, a. 6, 4. 7, a. 8, a. 9, 

5.0,5.1,5.2,5.3,5.4,5.5,5.6,5.7,5.8,5.9, 
6.0,6.1 ,0.2, 6.  _3 , 6 . 4, 6. 5, 6. 6, 6. 7, 6. 8, 6. 9} ; 
float  p  y  [  4  0 ]  {3.0,3.0,3.0,3.1,3.2,3.4,3.0,3.9,4.3,4.6, 
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5. 3/5. 6, 5. 9, 6. 1,6.3/6.5, 6. 6, 6. 7, 6. 8/6. 9, 
6.9,6.8,6.7,6.6,6.5,6.3,6.1,5.9,5.6,5.3/ 
a. 6, a. 3, 3. 9, 3. 6,3. 4, 3. 2, 3. 1,3. 0,3. 0,3.0); 

i  n  t  P  n  U  0  ,* 

float  pease  5.0; 

mainO 

{ramtekO;       //open  the  device 
screen (0 .0, 0.0 , 10.0 , 1 0.0) ;   //set  dimensions 
colort (7);     //color  table  7 
color(l);    //color  1 

axis(^.95,5.0);     //draw  axes  4 

s 1 eeo ( 3 ) ;     //oause 
c  o 1 o  r ( 7 ! ;     //color  7 

setnfiode(5,0);     //select  q^acnic  olot  m  c  a  e 
ploth (px,py»Dn,Dbase) ?    //clot  histogram 
s 1 eeo ( 3 ) ;     / /oause 
C0l6r(5);      //cnanoe  color 
setmode(4>0) ;     //change  mode 
o 1 ot 1 n ( ox , o v , en ) ;    //olot  the  'function' 
} 


C.   ADVANCED  METHODS 

The  use  of  the  graphic  clot  mode  for  any  more  oetailea 
operations  than  can  be  accord  ishen  by  the  "cloth"  routine 
will  require  the  user  to  consult  the  R  A  M  T  E  K  Gx-10  0  Program- 
ming Manual   [11. 
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XIII.   GRAPHIC  CARTESIAN  MODE 


A.  INTRODUCTION 

The  graphic  cartesian  mode  is  used  to  draw  solid  rectan- 
gles on  tne  RAi^TEK  screen.  These  rectanoles  must  be  defined 
by  two  diagonally  opocsite  corner  c  o  i  n  t  s  ,  the  second  of 
which  becomes  the  new  COP  after  comoieticn.  Since  these 
rectangles  may  oe  displayed  in  any  color,  the  user,  by 
choosing  the  background  color,  can  effectively  use  this  mode 
for  selective  erasure  of  rectangular  areas. 

B.  BASIC  USER  GUIDELINES 

Selection  of  tne  graohic  cartesian  mode  can  be  achieved 
by  a  call  of  the  for^ 

setmode(6rf); 

where  6  is  the  defined  number  for  this  mode.  The  parameter 
Hf"  should  have  the  value  0  to  turn  OFF  all  control  flags, 
or  the  value  1  to  leave  all  flags  as  they  were  set  prior  to 
this  call. 

The  simolest  i to  1 emen t a t i en  of  this  rode  is  through  the 
"block"  routine.  The  user  must  first  have  selected  his 
desired  color  by  using  the  "color"  routine.  Then  the  call  to 
"block",  which  reauires  four  real  numoer  oarameters,  would 
appea r  as  follows  : 
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b1ock(xl,yl,x2ry2); 

where  the  two  respective  coordinate  pains  define  two  diago- 
nally opoosite  comers  of  the  desired  b  1  o  c  •<  to  be  displayed. 
The  resulting  COP  will  oe  located  at  the  point  ( x 2 1 y 2 ) *  the 
last  to  be  transmittpc  to  the  R A M T E K . 

The  "block"  routine  does  out  the  R  A  Nl  T  E  K  into  the  graphic 
cartesian  mode  bv  itself  and  it  also  does  some  fairly  ela- 
borate error  c  h  e  c  k  i  n  a  .  But  a  quick  scan  of  the  source  cooe 
would  reveal  that  the  actual  rectangular  oisolav  is  generat- 
ed dv  issuing  a  "strtxy"  call  followed  o  v  a  "point"  call. 
The  user  is,  of  course*  f  r<*e  to  utilize  these  routines  also. 
In  fact,  in  so<ne  applications  they  are  essential. 

Thus  after  selecting  the  prober  mode  and  color*  the  user 
could  create  the  same  diSDlay  as  the  "  block "  call  atiove  by 
issuing  the  f  o  1  1  o  w  i  n  a  two  subroutine  calls  : 

S t r t x y  ( x 1  , y 1  )  ;    po 1  n t  ( x ? , y2  )  ; 
(assuming  the  oarameter  values  were  the  same  as  above). 

C.   ADVANCED  METHODS 

Althouoh  the  oasic  results  are  the  same/  a  variety  of 
approaches  are  available.  So^e  users  may  find  the  "cnintr" 
routine  convenient  in  applications  where  relative  aoaressmq 
becomes  easier  to  compute  than  acsolute.  Thus  after  using 
the  "strtxy"  routine  to  establish  an  initial  COP,  the 
"point r"  routine  could  be  called  reneateoly  (as  could 
"point")  to  aenerate  a  series  of  linkec  rectangles. 
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There  also  may  be  certain  applications  in  which  the  in- 
dexed addressing  feature  is  useful.  This  "nay  be  implemented 
by  the  "index"  routine  explained  in  Chapter  IV  under  "Virtu- 
al Screen  Addressing". 

I.   PROGRAM  17 

This  sample  program  is  available  in  the  "  c  s  2  0  0  0 
r  a  m  t  e  k  "  directory  to  graonically  demonstrate  the  effect  of 
the  separate  routines  in  this  rode.  The  user  snould  observe 
the  following  :  (1)  t^e  use  of  "block"  to  draw  a  block  in 
the  upper  left  auaorant  of  the  screen;  (2)  the  use  of 
" strtxy"  and  "ooint"  to  draw  a  similar  block  in  the  upper 
right  guaarant;  (3)  the  use  of  relative  addressing  wnen  us- 
ing "pointr"  to  generate  two  small  boxes  in  the  lower  right 
quadrant;  (4)  the  use  of  indexed  addressing  to  position 
three  small  boxes  in  the  lower  left  quadrant;  (5)  the 
'selective  erasure'  effect  achieved  oy  selecting  color  0  and 
drawing  over  part  of  the  block  in  the  upcer  riaht  auadrant. 


To  assist  the  user  in   accessing 
followina  guidelines  are    provided  : 

a.  To  use  the  c s 2 0 0 0  directory  : 

LOGIN:  c  s  2  0  0  0    c / r 
PASSWORD:  stucent    c / r 
cd  ramtek    c/r 

b.  To  list  the  orcoram  : 

list  -c  o 1 7 . c    c/r 
c/r 


this   p roq ram   the 
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c.  To  execute  the  program 


p 1 7 . x    c/r 


d .  The  listing  follows 


//o 
0,2 


mainO 

{ ramt ek  (  )  ? 
screen(0.0,0 
setmode(b,  0  )  ? 

c  o l o  p  t ( 7 ) ;    // 

color(l);  / / 
block (3.0,13.0,7 
sleeo(2);  //p 
strtxyC13. 0,17.0 
ooint ( 17.0,  1  3.0) 
si eeo(2) ;  // 
c  o  1  o  r  (  3  )  ;  /  / 
s  t  r  t  x  y ( I  7 . 0,7.0) 
do  i  n  t  r ( - 2 . 0,-2.0 
ooi  nt  r (-2 . 0 , -2  .  0 
sleep(2);  / / p 
colord  )»  /  /c 
index (1,1.0,1.0) 
strtxy(2. 0,2.0); 
ooi  nt (« . 0, 4.0) ; 
c  o  1  o  r  (  5  )  ;  / / s  e 
strtxy(3. 0,3.0), * 
ooi  nt (5.0, 5.0 ) ; 
color(7);  //se 
s  t  r  t  x  y  ( a  .  o  ,  a  .  o  ) ; 
poi  nt (6  .  0 , 6.  0  )  ; 
sleep(2);  //p 
i  naex (0,0.0,0.0) 
color(O);  //se 
block (13.0,13.0, 
> 


oen  the  device 

0.0,20.0);   //set  a  i  m e  n s  i  o  n s 

//select  graohic  cartesian  mode 

se 1 ec  t  color  table  7 

select  color  1 

.0,17.0);   //craw  a  block 

ause 

) ;    //est ab 1  i  sh  new  COP 

;     //draw  a  M  o  c  < 

pause 

select  color  3 

//establish  new  COP 
//draw  "relative"  to 


)  ; 

)  ; 

ause 

o  1  or 


COP 


// 


1 


//••index"      from      (1.0,1.0) 

//set     new    COP 

//draw  a  Mock 
I  ec  t  color  5 

//set  new  COP 
//draw  a  block 
1 ec  t  color  7 

//set  new  COP 
//oraw  a  block 
ause 

;   //turn  OFF  index  flag 
lect  background  color 
15.0,15.0);  //"erase"  Part 


of  a  Mock 
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XIV.   GRAPHIC  ELEMENT  MODE 


A.  INTRODUCTION 

This  mode  involves  activatina  or  'painting'  individual 
elements  ( o  i  x  e  1  s  )  en  the  R  A  M  T  E  K  screen,  ^  n  e  n  ooeratina  in 
the  graphic  element  ^  o  d  e  t^e  user  m  u  s  t  computer  either  o  r  o  - 
grammatically  or  by  nana*  the  virtual  screen  coordinates  cf 
each  pixel  that  r»  e  desires  activated.  As  such,  its  use  may 
may  not  seem  as  attractive  as  some  other  mooes,  yet  for  some 
applications  this  mode  may  prove  extremelv  useful. 

B.  BASIC  USER  GUIDELINES 


The  graonic  element  mooe  may  be  selected  by  a  call   such 


as 


set  mode (  7  ,  f  )  ; 
where  7  is  the  designated  number  of  tnis   mode.   The 
parameter  ff)  should  cp  a  '0'  f-  o  turn  OFF  all  contro 
or  a  '1'  to  leave  the  flaas  as  thev  were. 


second 
f 1 ags / 


By  its  nature,  this  mode  demands  an  increased  awareness 
of  the  virtual  screen  dimensions.  The  screen  may  be  dimen- 
sioned to  any  size  the  user  desires  by  a  call  of  the  form  : 

screen(xmin,yminfxmax,vmax'); 
which   will   result   in   the    minimum    coordinate    values 
representing   the   lower   left   corner  of  tne  screen  and  the 
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maximum  values  representing  the  ucoer  right.  There  are  some 
instances  when  viewing  the  screen  in  its  'real'  dimensions 
will  help.  This  may  be  acnievea  by  usina  the  "screen" 
routine  to  set  the  6^0  by  2  4  u  dimensions  by 
screen(0.0,0.0,b4u. 0,24 0.0).  One  of  the  more  useful  appli- 
cation routines  in  this  mode  is  the  "plotpt"  routine.  This 
procedure,  as  with  "ploth"  and  "plot  In"  in  previous 
chapters,  requires  as  parameters  two  eaual  length  arravs  of 
real  numbers  and  an  integer  value  defining  that  length.  Thus 
if  the  following  arrays  were  declared  and  initialized  : 

float  pxlnl  {xl,x2,x3,....,xn>; 

float  py [n 1   <yl,y2,y3,....,yn>; 
then  the  suoroutine  call 

plotPt(px,oy,n); 
would  correlate  the  'n'  values  from  "ex"  and   "oy"   and   ac- 
tivate  those   ' n '  inaivioual  oixels  on  the  screen  according 
to  the  currently  selected  color. 

The  "plotpt"  routine  actually  makes  a  series  of  calls  to 
the  familiar  "point"  function.  In  this  mode,  the  "ooint" 
routine  is  usee  to  address  individual  elements  on  the 
screen,  not  to  define  the  ena  ooint  of  some  vector  or  block 
drawing  proceoure  as  before.  Thus  the  user  may  utilize 
"point"  to  activate  arbitrary  oixels.  This  can  be  helpful 
when  plotting  some  function  whose  values  are  not  known 
before-hand,  (see  sample  orooram  below) 
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The  "pointr"  routine  may  also  be  used  to  address  some 
element  relative  to  the  previously  adaressed  element  (loca- 
tion of  COP).  The  reverse  background  and  indexed  addressing 
flags  which  were  exclained  in  "Control  Modes  and  Flags" 
(Chao  IV)  are  applicable  to  this  mooe. 

1.   PROGRAM  18 

The  followinq  o  r  c  a  r  a  m  ,  when  executed  will  compute 
and  plot  the  points  alone  the  circumference  of  a  circle.  At 
the  same  time*  it  uses  the  results  of  its  SIN  function  com- 
putations to  plot  a  portion  of  a  sine  curve  within  the  cir- 
cle. This  program  is  in  t-ne  " c S 2 0 0 0  -  r a m t e k "  directory  and 
can  be  accessed  as  follows  : 

a.  To  use  the  c s 2 0 0 0  directory  : 

LOGIN:  cs20  00    c/r 
PASSWORD:  stucent    c/r 
cd  ramtek    c/r 

b.  To  list  tne  orcoram  : 

list  -c  oLB.c    c/r 
C/r 

c.  To  execute  the  program  : 

pi  8  .  x    c/r 

d.  The  listing  follows  : 

double  sin(); 

douo 1 e  cost); 

float  ox  ; 

float  o  y ; 

float  or  3.0?     //radius  of  circle 

ma  i  n  (  ) 

{float  i  1 1 ; 
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ramtekO;     //ooen  the  device 

screen(-S.0/-5. 0,5. 0,5.0);   //set  dimensions 
colort (7);     //color  table  7 
c  o 1 o  r ( 5 ) ;      //color  5 

setmode(7/0);    //select  araphic  element  mode 
for(i  =  0.0;i  <  o. 28318, *i  =  i  +  0.01) 
{px  =  pr  *  cos(i); 

t  =  s  i  n  (  i  )  ,* 

py  =  o  r  *  t  ; 

ooint(ox,ov);     //plot  the  circle 

if(i  <=  6.0)  ooint((i-3),t);   //olot  sine 
} 


C.   ADVANCED  METHODS 

The  graphic  element  mode  seems  best  suited  for  plotting 
a  series  of  ooints  that  are  computed  by  the  apolication  pro- 
gram itself.  Depending  on  the  desired  display,  some  Projects 
that  reauire  the  user  to  ore-comoute  his  data  ooints  might 
be  more  adaptable  to  one  of  the  Data  moaes.  (see  Paster  and 
Transverse  Data  Modes) 
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XV.   R  A  v  T  E  K  INTERACTIVE  KEYBOARD 


The  R  A  M  T  E  K  keyboara  is  software  a  d  a  o  t  e  d  to  be  utilized 
as  an  interactive  tool  bv  the  R A M T E K  user.  This  keyboard 
(located  in  front  of  the  G  X  -  1  0  0  A  )  is  ON  when  the  green 
switch/light  (in  the  uocer  r  i  q  h  t  corner)  is  glowing;  to  ac- 
tivate tne  Keyboard  when  it  is  OFF,  aepress  the 
switch/light.  Tne  keyboard  is  configured  as  shown  in  Figure 
3. 

Referrinq  to  Figure  3  /  f  h  e  user  will  note  that  there 
are  eighty-nine  (69)  keys.  £acK  <ey  may  have  from  one  (1)  to 
three  (3)  states  (ucoercase*  lowercase/  control).  The  user 
has  available  237  distinct  cooes  that  mav  be  transmitted  via 
the  keyboard/  with  the  ASCII  code  being  utilized  for  all 
keys.  The  decimal  representation  of  the  actual  code  returned 
from  selecting  a  particular  key  is  shown  in  Figure  4. 

The  system  software  has  been  desianed  to  allow  the  user 
to  read  keyboard  inout  quite  easily.  The  three  functions 
that  allow  the  user  to  interact  with  the  keyboard  can  pro- 
vide indiviiual  ASCII  characters/  inteoer  numbers/  or  real 
numbers  deoendinq  on  the  function  utilized. 

In  addition  to  reading  from  the  keyboard/  the  user  may 
echo  print  back  to  the  R A M T E K  screen  individual  ASCII  Char- 
acters as  they  are    reao.  The  system  support  routine  "out (n)" 


13a 


provides  this  capability  ("n"  is  an  ASCII  cooed  character). 
The  function  "out (n)"  automatically  repositions  the  COP  one 
character  to  the  rioht  to  prevent  over- writing. 

The  function  that  returns  individual  ASCII  characters 
to  th*3  user  is  "retcharO".  To  read  a  character  from  the 
RAM[EK  keyboard  the  user  would  issue  a  call  of  the  form 

x  =  retcharf); 
This  will  result  in  "x"  heina   assigned   the   value   of   the 
selected  key . 

A.   PROGRAM  10 

This  proaram  will  reaa ,     and  echo   print   to   the   P A M T E K 

screen*   characters   selected   from  the  R A M T E K  keyboard  (NOT 

ALL  SELECTIONS  APE  PRINTABLE).  The  program  terminates  when  a 

single  carriage  return  is  incut. 

l.To  use  tre  cs2000  directory: 

LOGIN:  cs200  0  c/r 

PASSWORD:  student  c/r 

cd  ramtek  c/r 

2..  To  list  the  program: 

list  -c  d!9  .c  c/r 

3. To  execute  the  proaram: 

pl9.x  c/r 

4. Proaram  listing  follows: 

^define  CR  13 
ma  i  n  (  ) 

{ int  x;  //inteaer  variable 

ramtek();  //initialize 
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c  o 1 o  r  t ( 7 ) ;  c  o 1 o  r ( 2 ) ;  //select  colors 
while  ((x  =  retcharO)  i=  CR)  //loop 

{  s  t  r  t  x  y  (  5  0  .  0,50.0);  //set  cositon 

out(x);  //echo  character 

> 
> 

To  read  an  integer  from  the  RA^iTEK,  the  user  depends 
upon  tne  system  function  "getiO"  •  To  read  an  integer  quan- 
tity from  the  key  board  the  user  issues  a  call  of  the  form 

y  =  get  i  ( )  / 
The  function  " ge  t  i  O "  recoonizes  a  carriage   return   as   the 
end   of   the  incut  value.  To  input  tne  value  one  hundred  the 
user  woula  type  (at  the  R A M T E K  keyboard)  : 

i  0  0    c  /  r 
A  negative  one  (-1)  is  returnee   if   a   carriaae   return   is 
typed   as   the   first   character.   Tne    only  valid  inputs  are 
lowercase  numbers;  all  others  are     ignored. 

B.   PROGRAM  20 

This  program  allows  tne  user   to   incut   inteoer   values 
from   the   Keyboard   until  a  carriage  return  is  tyoed  as  the 
first  character  in  a  new  number.  The  integer  value  is  outout 
to  the  R  A  M  T  E  K  screen  for  user  verification  (see  "itoal(x)"). 
l.lo  use  the  cs2000  directory: 
L  G  G I N :  c  s  2  0  0  0  c/r 
PASSWORD:  stuaent  c/r 
cd  ramte<  c/r 
2. To  list  the  oroaran: 

list  -c  p  2  0  .  c    c/r 
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3. To  execute  the  crogram: 

p20 .x  c/r 

4. Program  listing  follows: 

ffrief ine  CR  13 
ma  i  n  (  ) 

<  int  k;  //inteaer  variable 
ramte<();  //initialize 

colort (7) ;  colorC?)?  //select  colors 
while  ((<  =  getiC))  1=  CR)  //looo 
(st rtxy(50. 0,50.0) ;  //set  COP 
'toal(k)*  //output  value 
> 

To  read  a  real  number  from  the  RAMEK  keyboard  the  user 
will  call  " o  e  t  f ( ) " .  The  user  would  issue  a  call  of  the  form 

y  =  get  f (  ) 
to  read  a  real  number.  The  result  would  be  the  assignment 
of  a  real  number  to  the  variable  "y".  The  function  "  g  e  t  f  (  )  " 
recognizes  a  carriage  return  as  the  end  of  the  incut  value. 
Only  lowercase  numbers,  "e"  for  exponential,  "+"  or  "-",  ana 
"."  are    valid  incuts  to  the  routine;  all  others  are  ignored. 

The  user  should  now  be  able  to  effectively  use  the  key- 
board as  a<^  interactive  fool.  For  soecifics  on  the  functions 
see  Aooend i  x  3  . 
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XVI.   SPECIAL  APPLICATION'S  ROUTINES 


The  Durpose  of  this  chaoter  is  to  present  those 
routines  from  the  software  support  oackage  which  are  not  an 
intearal  part  of  any  tonic  discussea  earlier/  ana  which 
would  otherwise  be  omitted.  Some  of  the  routines  in  the  sup- 
port oackage  are  merelv  suborainate  oarts  of  larger  routines 
and  serve  no  stand-alone  purpose.  These  will  not  be  dis- 
cussed. The  routines  cresentea  here  are  those  that  m  i  g  n  t  be 
emoloyea  by  a    user's  aoclicaMon  croararr. 

There  is  only  one  routine  in  the  support  package  that 
reguires  knowledge  of  the  fact  that  this  device  actually  has 
512  raster  lines  --  ^£0  of  which  are  visible  and  3  2  of  which 
are  off  the  bottom  of  the  screen.  This  is  the  "scroll"  func- 
tion/ wnic1"!  is  used  to  make  a  display  move  ud  or  gown  by  a 
certain  number  of  real  lines.  If  a  oortion  of  the  oisplav  is 
'scrolled'  off  the  too  of  the  screen/  it  will  'wrap  around' 
ana  reaopear  at  the  bottom  (and  vice  versa).  Thus  the  h2. 
non-visiole  lines  that  exist  off  the  bottom  of  the  screen 
must  oe  taken  into  consi aeration  when  making  use  of  this 
feature.  J  re    subroutine  call  would  apoear  as 

scrol  1  (di  recti on/numl  ines)  ; 
where  the  parameter  "cirection"  must  oe  either  a  "u"  for   UP 
or   a   "dM   for   D  0  w N /  and  the  "numline"  parameter  is  a  real 
number  denoting  the  number  of  real  screen  lines  the   a i splay 
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shou Id  be  moved . 

In  previous  cuacters/  screen  addressing  has  been 
presented  in  terms  of  the  virtual  screen.  There  are  two 
routines  that  mao  these  virtual  addresses  into  real  (ana 
visible)  screen  locations  for  the  actual  di  sol  ay  generator. 
These  are  "conve"  and  "convl".  The  "conve"  function  con- 
verts the  *  coordinate  into  a  r^al  screen  element  oosition. 
The  "convl"  function  converts  the  V  coordinate  into  a  visi- 
ble real  screen  line  numoer.  The  combination  of  these  two 
define  an  element/line  intersection  or  c  i  x  e '  .  These  func- 
tions are  used  internally  by  all  the  software  d  i  s  n  1  a  y 
routines  to  convert  user-def inea  addresses  to  real  screen 
locations  Defore  oassinq  these  to  the  RAMTEK  buffer  for 
display.  Tnese  two  orccedures  may  be  e^oloveo  bv  the  user 
with  individual  calls  such  as 

ccnve(xj;  convl  (y); 
where  "x"  and  "y"  are  t  n  e  real  numoers  of  the  desirea  virtu- 
al screen  address- 
In  order  to  d  i  S  o  1  a  y  a  given  inteaer  value  (in  the  range 
of  -32767  to  +32767)  on  the  screen,  the  "itoal"  routine  may 
be  used.  This  routine  *ill  convert  the  qiven  integer  oaram- 
eter  into  its  ASCII  code  ana  display  the  desired  integer 
value  on  the  screen  at  the  COP.  The  call  would  be 

itoal(n); 
where  "n"  is  any  valio  integer  value. 
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Likewise^  the  " f t O a "  function  may  be  used  to  displav  a 
real  number  with  no  more  than  nine  digits  to  the  left  of  the 
decimal  ooint  and  no  more  than  four  digits  to  the  right. 
Thus  if  " x "  were  a  valid  real  n  u  m  o  e  r  ,  the  call 

f  t  o  a  (  x  )  ; 
would  display  the   decimal   reo resen t a t i en   of   that   number 
(complete   with   decimal   point)  on  the  R A M T E K  screen  at  the 
location  of  the  COP. 

The  "out"  function  takes*  as  a  sinale  parameter,  t  n  e 
ASCII  code  for  any  valid  character  ana  "dufes"  it  to  the 
RAMIEK  to  disolay  that  character.  Since  the  ASCII  code  for 
the  character  is  required*  this  may  be  achieved  in  two  ways. 
First/  the  character  ray  oe  enclosed  in  single  auotes  within 
the  subroutine  call,  sucn  as 

o  u  t  (  •  x  '  )  ; 
to  display  the  letter  x;  or,  second,  if  the  user  pre-defines 
a  character,  such  es  with 

cdefine  COMMA  054 
then  the  c  ^  I  1 

out (COMMA) ; 
would  display  a  comma  at  the  location   of   the   COP.   The   x 
value   or   element   position   of  the  COP  is  incremented  by  7 
elements  to  crevent  destroying  that  cnaracter  with  the   n  e  *  t 
to  be  displayed,  (see  "Alohanumerie  v'ode") 

As  briefly  mentioned  in  the  "Alphanumeric  ("'ode"/  r  3  w 
data   is   cassed   to   the  R  A  m  t  E  K  by  the  "dumc"  routine.  T  n  i  s 
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procedure  senas  a  ore-declared  number  of  bytes  of  data  from 
the  software  buffer  (called  "buff")  to  the  H  A  M  T  E  K  hardware 
buffer.  The  numoer  of  bytes  to  be  oassea  is  normally  kept  in 
"bytecnt".  The  address  of  the  next  available  location  in 
"buff"  is  keot  in  a  oointer  called  "ctrbuff".  Thus*  for  ex- 
ample, to  sena  the  octal  value  060017  to  the  RAMTEK,  the 
following  instructions  would  be  used  : 

*ptrbuff  =  06  0  017; 

ot  rbuf  f f  +  ; 

bytecnt  =  bvtecnt  +  2; 

dumD(buff/bytecnt  )  ; 

To  operate  at  this  level  in  the  RAMTEK  environment*  the 
user  should  familiarize  himself  with  the  RAMTEK  GX-100  Pro- 
gramming Manual  HI  and  the  RAMTEK  software  source  code 
available  in  the  Lao . 
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A^PfcNDIX  & 

SOFTWARE  SUPPORT  FUNCTION  DESCRIPTIONS 

This  Apoendi  x  contains  the  descriptions  of  the  user   in 
terface  routines  in  the  format  that  is  follower)  in  the  docu' 
mentation  of  the  UNIX  operating  system  in  the  '.aval  Postgra1 
duate  School  Comcuter  Laboratory. 


1  a  '4 


RESERVED  WORDS 


AuOFF 

adon 
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axis 

BKON 

BKOFF 

b  k  r  n  d 

blank 

BLK 

block 
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buf 
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b  u  t  b  1 

bytecnt 

c 

chco  1 

chnge 

c 1  rho  1  d 

c 1 rtbl 
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code  i  t 

coke 
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conve 

conv  1 
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CH 
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da  t  ap 

db  1  w  i  a 

di  sp 

dsoyc  t b 1 

dump 
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LTD 
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SCR 
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SDCU 
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setup 
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SSCALL 
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s t  rou  t 
s t  r t  xy 
swary 
Symbo 1 
systbl 

abco 1 o  r 

abd  i  m 

ab  i  n  i  t 

abs  w 

b  1  who 

data 

e  r  se 

ex  t  o 

fpi 

RANSD 

r  i  p  1  e 

x 

x  d  i  m 

x  m  a  x 

x  m  i  n 

V 

y  d  i  m 
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axis 


May  21  1977 


axis 


NAM£ : 


axis  -  draw  coordinate  axis 


SYNOPSIS: 

a  x  i  s  (  x  f  y  ) 
float  x ,  y ; 


DESCRIPTION: 

Draws  a  cartesian  coordinate  x  and  y  axis  on  tie 
screen  with  center  at  user- defined  screen  coordinate 
(x»y). 

The  operation  is  totally  inaeoendent  of  any  control 
mode  issueo  or»viously. 

The  CQP  is  left  at  (max  x-value»y). 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  nc  oortion  of  the  axis  lies    on 
the  user-aefinec  screen. 


1  4b 


bk  rnd 
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bk  rnd 


NAM£: 


bkrnd  -  cnange  reverse  cackground  flag 


SYNOPSIS: 

bk  rnd ( a) 
i  n  t  q  ; 


DESCRIPTION: 

If  a  is  zerof  the  reverse  background  flag  in  the   con- 
trol mooe  is  set  to  zero/  i.e.  turned  off. 

If  q  is  equal  to  one#  the  reverse  background   f 1 ag   in 
the  control  rr  o  d  e  is  set  to  one/  i.e.  turned  on. 

Normal  return  is  zero. 


DIAGNOSTICS: 

"eturned  -1  indicates  t  b  < 
equal  to  zero  or  o^e. 


cassed   integer 


is   not 
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block 


May  21  1977 


block 


NAMt: 


block  -  draw  soHo  block 


SYNOPSIS: 

block  (xl,yl, x2,y2) 
float  x 1 / y 1 1 x2»  y2; 


DESCRIPTION: 

A  solid  rloc<  is  ctra^n  with  cocosite  corners  as  de- 
fined by  user-defined  screen  coordinates  (  x  1  ,  y  1  )  ana 
Cx2,y2) . 

The  COP  is  left  at  (x2*y2).  The  operation  is  indepen- 
dent of  any  Tiode  issued  previously  but  is  sensitive  to 
all  flags  =)col  icable  to  Graphic  Cartesian  m  o  o.  e  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oloc*  can  not   be   orawn   on- 
the  user-aefinec  screen. 


SEE  ALSO: 

index()»  bkrnoOr  dblwioO 


me 


bui 1 dsw 


4a v  21     1^77 


bui 1 dsw 


NAML: 


b  u  i  I  d  s  w  -  build  logical  switches  on  the  tablet 


SYNOPSIS: 

bui  ldsw(sw/xh,xl  r  y h  r  y 1  ) 

float  x  h  /  x  1  , y  h  ,  y  1  ; 
i  n  t  swl 


DESCRIPTION: 

Allows  the  user  to  define  individual  logical 
'switches'  on  the  Vector  General  Taolet  by  passing  the 
following  oarameters  : 

1-user's  logical  switch  number  (integer) 

2-hiah  x  value  (real) 

3-low  x  value  (real) 

4  -  h  i  g  h  y  value  (real) 

5  -  1  o  *  y  value  (real) 

-  -  thus  defining  a  selection  oox  and  assigning  it  t  n  e 
desired  number.  v  a  x  i  r  u  ti  number  of  switches  is  <?  5 . 


DIAGNOSTICS: 

Normal  return  is  the  switch  number. 
Returned  -1  indicates  attempt  to  create 
sw  i  t  c  hes . 


more    than 


25 


SEE  ALSO: 

s  i  xpak ( ) ; 


t absw  (  )  ; 
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Chnge 
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C  hnge 


NAME  : 


chnge  ~  chance  color  table  entry 


SYNOPSIS: 

chnge(nurrbrentry,cont  ) 
i  n  t  numb/  entry/  contl 


DESCRIPTION: 

Chanoes  the  sceci  f iea  entry  in  the  indicated  color 
table  to  the  casseo  parameter  cont.  trioleC)  should 
be  used  to  out  cont  into  the  orooer  form. 

numb  is  the  table  number  in  which  the  entry  is  to  be 
cnanqed.  entry  is  the  entry  number  to  be  chanqed. 
cont  is  the  inteaer  twelve  bit  code  which  is  loadea  in 
the  specified  entrv. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are     inaicated  t>y  negative  returned   values. 
The  error  values  and  their  meanings  are    as  follows: 

-1    Indicates  rumb  is  less  than  four  or  greater   than 
seventeen. 

-2    Indicates  entry  is  negative  or  oreater  than   fif- 
teen. 


SEE  ALSO: 

t  r  i  p  1  e  C  ) 
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cl rtbl 


Mav  21  1^77 


cl rtbl 


name  : 


clrtbl  -  load  color*  table 


SYNOPSIS: 

c 1 r t  d 1  ( n / n ame ) 

i n  t  n ,     *name; 


DESCRIPT ION: 

Loads  color  table  dumber  n  with  the  codes  contained  in 
the  array  oointed  to  ny  name \ 

The  array  is  an  integer  array  containing  sixteen  in- 
tegers which  represent  the  octal  code  of  the  color 
table  entries  re*"ween  zero  and  fifteen.  The  array  is 
assumed  to  be  declared  sixteen  words  in  length. 

n  is  an  integer  value  which  ranges  from  four  to  seven- 
t  een  . 

The  color  tables  from  zero  to  four  are    system   defined 

tables.   They  contain  the  following: 

Taole  0  -  Fifteen  shades  of  orey. 

Table  1  -  Fifteen  shaaes  of  blue. 

Table  2    -    Fifteen  shades  of  green. 

Table  3  -  Fifteen  shades  of  red. 


If  the  user  desires   to   modify 
i  n  t  e  r  (  )  . 


system   table   see 


lormal  return  is  zero 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed   inteoer   n   is   less 
than  four  or  greater  than  seventeen. 


SEE  ALSO: 

triplet) 
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color 
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color 


NAME: 


color  -  select  color 


SYNOPSIS: 

co 1  or ( s ) 
i  nt  s ; 


DESCRIPTION: 

The  passed  inteaer  s  is  •'he  number  of  the  desired  en- 
try in  the  current  color  table.  The  color  located  in 
that  entry  will  he  u  ^ed  for  aM  subsequent  entities 
displayed  until  a  different  color  is  issued. 

s  is  net  ween  zero  and  fifteen. 

Normal  return  is  zero. 


DIAGN031 ICS: 

Returned  -1  indicates  the  oassed  integer  s  is  negative 
or  greater  than  fifteen. 


SEE  ALSO: 

C  hnae ( ) 


15? 


co  1  o  r  t 
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CO  1 ort 


NAME: 


colort  -  select  ii  scl av  color  table 


SYNOPSIS: 

col ort ( t ) 
i  nt  t  ; 


DESCRIPTION: 

The  nassed  oararreter  t  is   the   number   of   the   color 
table  that  is  sent  to  the  R A N T E K  aevice  for  display. 

t  is  between  zero    and  seventeen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassea  inteaer  t  is  negative 
or  areater  than  seventeen. 


SEE  ALSO: 

c 1  rtcl  (  ) 
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conve 
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conve 


NAME: 


conve  -  convert  an  x  value  to  an  element  location 


SYNOPSIS: 

conve ( x ) 
float  x ; 


DESCRIPTION: 

Converts  a  virtual  screen  x-dimension  value  or  adaress 
into  a  real  screen  element  cosi  t  ion.  The  floating 
coint  oara^eter  must  te  a  valid  address  component  for 
the  current  virtual  screen  soace. 


DIAGNOSTICS: 

Returns  the  number  of  the  real 
t  i  on  . 


screen   element   posi- 


SEE  ALSO: 

C  o  n  v  1  (  )  ; 


15a 
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conv  1 


NAME: 


convl  -  convert  a  v  value  to  a  real  screen  line  nymoer 


SYNOPSIS: 

convl  ( y  ) 
float  y ; 


DESCRIP1 ION: 

Converts  a  virtual  screen  y-di  tension  value  into  a 
real  screen  line  number.  Tne  floating  point  parameter 
r^ust  oe  a  valio  address  component  for  the  current  vir- 
tual screen  soace. 


DIAbNQST  ICS: 

Returns  the  nu^cer  of  the  real  screen  line 


SEE  ALSO: 

c  o  n  v  e  C  )  ; 
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cursor 


NAME: 


cursor  -  software  cursor  ( V .  G .  tablet  driven) 


SYNOPSIS: 

cu  rso r C  )  } 
extern  float 


t  x  ,  t  y  ; 


OESCRIPT ION: 

This  routine  ol aces  a  cursor  on  the  screen  of  the  R  A  K  - 
TEK  in  color  15  of  the  current  color  table.  The  Cursor 
is  destructive  in  thai-  it  erases  everything  tnat  it 
passes  over.  Control  of  the  cursor  is  via  the  VECTOR 
GENERAL  tablet.  When  the  pen  is  depressed  the  cursor 
ch'sanoears  and  exits.  The  x  and  y  values  of  the 
pen/cursor  location  are  saved  in  tx  ana  ty  (must  be 
qlobel  to  the  user  croaram)  for  the  user. 


DIAGNOSTICS: 
none 


SEE  ALSO: 

terse()  ,     q  e  t  x  y  ( )  ,     tabdi-nO  ,  tabinitO  >     screenO 
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data 


NAME: 


data  -  disolay  raw  oata 


SYNOPSIS: 

dat  a ( name  t  1  ) 
i  n  t  *  n  a  m  e  f     1  ; 


DESCRIPTION: 

The  raw  oata  passed  in  the  linear  array  pointed  to  by 
name  is  displayed  on  the  RAM  1 1  k  accoroi  no  to  the 
current  control  mode. 


1  is  tne  lenath  of  the  array  in  bytesi 
Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  - 1  indicates  the  oassea  integer  1 
or  zero. 


is  neaative 


SEE  ALSO: 

st  rout  (  )  ,     1  t  t  r  (  ) 
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db 1 w  i  d 


NAME: 


dblwia  -  charge  ^ounle  wiatn  flag 


SYNOPSIS: 

dbl w i d(x ) 
i  n  t  x  ; 


DESCRIPTION: 

If  x  is  equal  to  zero/  the  aouble  width   flag 
control  ^oae  is  set  to  zero*  i.e.  turned  off. 


in   the 


If  x  is  equal  ro  one/  the  nouble   t*iath   flag 
control  mode  is  set  to  one/  i.e.  turned  on. 


in   the 


Normal  return  is  zero. 


DIAGNOST ICS: 

Returned  -1  indicates  the   passed   integer   x   is   not 
equal  to  zero  or  one. 


SEE  ALSO: 

sized 
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d  i  sp 


NAME: 


disp  -  oi  solav  a  selectee  color  table  (long  form) 


SYNOPSIS: 

d  i  s  p  (  n  )  ; 
i  n  t  n  ; 


DESCRIPT I  UN: 

The  color  taMe  debated  bv  the  integer   parameter   '  n ' 
is   d  i  s  o  1  a  v  e  r!  on  the  screen,  along  with  the  octal  code 

reaui  rea  to  generate  each  entrv. 


SEE  ALSO: 

dspvc tb 1  (  ) 


15° 


dsoyc  t  b 1 


May  2  1  1^7  7 


d  s  p  y  c  t  b  1 


NAMt : 


dspyctol  -  aisDlay  a  selected  color  table 


SYNOPSIS: 

d  s  d  y  c  t  b  1  (  j  )  ; 
i  n  t  j  ; 


DESCRIPT  ION: 

The  colon  table  denoted  by  the  integer  oararreter  'j' 
is  displayed  on  tne  R  A I*  T  E  *  .  Background  color  is  entry 
0;  aisolay  color  is  entry  15. 


SEE  ALSU: 

disp(  ) 
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dump 


NAME: 


dump  -  send  raw  data  to  the  R  A  M  T  E  K 


SYNOPSIS: 

dump(buff/bytes)  > 
char  *bu  f f  t 
i  n t  bytes; 


DESCRIPTION: 

Writes  rax  oat  a  tc  the  R  A  M  T  E  K  instruction  buffer.  This 
routine  is  for  lo*  level  control  of  t^e  KAN.  TE*  ana  is 
very  restrictive.  Tne  raw  data  is  interoreted  accord- 
ing to  tne  mooe  and  flaas  set  within  the  device. 

DIAGNGSI ICS: 
none 


SEE  ALSO: 

writeO  ,  PANTEK  PROGRAMMERS  MANUAL 
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erase 


NAME: 


erase  -  erases  the  screen 


SYNOPSIS: 

erase (  ) 


DESCRIPTION: 

The  R A M T E K  screen  is  erased  to  the  current   background 
color  ( ie»  the  state  of  the  reverse  bacKground  flag). 


lb? 
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f  i  xot 


NAME  : 


f  i  x  p  t  -  chanae  fixed  c  o  i  n  t  f  1  a  g  in  control  moae 


SYNOPSIS: 

f  i  xp t  (  x  ) 
i  n  t  x  ; 


DESCRIPTION: 

If  x  is  eaua 
control  mode 


1  to  zero»  the  fixed 
is  set  tc  ze  ro  r     i.e 


co  i  n  t   flag 
turned  off. 


If  x  is  ecual  to  one»  the  fixed  coint  flag  in 
trol  mode  is  set  to  one;  i.e.  turned  on. 


in   the 


the  con- 


Meaningful  only  in   Graphic   Vector   or  Graohic   Plot 

mode.   In  Graphic  Vector  moae  it  causes  all  sucsecuent 

vectors  to  oe  drawn  from  a  common  ooint  as  issued  by  a 
sudseauent  (or  t^e  las'"  orevious)  strtxy().  In  Graphic 

Plot  moae  this  flag  is  used  to  achieve  the   histogram 
style  olot  of  "plothO". 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returnea  -1  indicates  trie 
egual  to  zero  or  one. 


c  assed 


i n  t  eae  r 


i  s 


no  t 
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f  toa 


NAME: 


ftoa  -  converts  real  numbers  to  ASCII  for  output 


SYNOPSIS: 

ftoa(in); 
float  in; 


DESCRIPTION: 

Converts  a  floating  noi^  number  tc  an  ASCII  code  so 
that  it  -rav  be  cutout  <*c  the  R  A  M  T  E  K  .  The  passea  float- 
ing ooint  number  is  first  convertea  to  the  ASCII 
reoresentat  ion  and  t  n  e  n  out  cut  to  the  3  A  y T  E  K  screen  at 
the  user  oefinec  COP.  Al 1 owS  for  only  four  oiaits 
right  of  the  decimal  c  1  a  c  <*  and  eight  digits  left  of 
the  nee  i  ma  1  dace. 


DIAbNOSl ICS: 
none 


SEE  ALSO: 

data ( )  , 


i  toa 1  ( ) 


loa 


aet  t 


lay  21  1^77 


get  f 


NAME: 


aet  f  -  read  floating  point  number  from  R  A  N"  T  E  K  keyboard 


SYNOPSIS: 

get f  (  ) 


DES0RIP1  ION': 

Returns  a  floating  point  number  from  the  R  A  M  T  E  K  key- 
board, fne  only  numbers  recognized  are  l  an  optional 
minus  sioo  followed  by  a  strina  of  digits  optionally 
containing  one  oecimal  pnint*  then  followed  cotionally 
by  the  letter  ' e '  followed  bv  a  signed  integer. 

Normal  return  is  the  floating  Doint  number. 


SEE  ALSO: 

oetnum()f  retchar() 
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get  i 


NAME: 


qeti  -  return  an  integer  from  the  R A M T E K 


SYNQPSIS: 

get  i  ()  ; 


DESCRIPTION: 

Returns  an  integer  value  from  the  RA^TEK  keyboard. 
ASCII  characters  between  0  and  9  ,  inclusively  r  are 
recognizea;  all  others  are  ignored.  Upon  typing  a  car- 
riage return  the  orocess  beqins;  nence  carriage  return 
denotes  end  of  string. 


DIAGN0S1 ICS: 
none 


SEE  ALSO: 

atoiC)  /  retchar() 
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ae tnum 


name: 


g  e  t  n  u  m  -  read  number  from  R A M T E K  keyboard 


SYNOPSIS: 

get  num (base ) 
int  base; 


DESCRIPTION: 

Returns  a  positive  or  n  e  a  a  t  i  v  e  inteaer  number  from  the 
RAMI  Eft  keyboard.  .Numerals  typed  up  to  a  comma  or  a  c/r 
on  the  keyboard  are  considered  to  be  the  number.  Tne 
routine  will  not  return  any  value  until  a  c/r  or  a 
comma  is  tvpeo/  nor  will  if  accept  characters  other 
than  digits  from  zero  to  nine  when  oase  is  eaual  to 
ten/  or  die  its  from  zero  to  seven  in  case  of  base 
e  i  ah  t  . 


base  is  the  base  of  tne  inteaer  number   returned, 
is  restricted  to  eiaht  (octal)  or  ten  (decimal). 


It 


Normal  return  is  the  inteaer  number 


DIAGNOST ICS: 

All  errors  are     indicated  cv  negative  returned   values. 
Tne  error  values  ana  their  meanings  are    as  follows: 

-1    Inaicates  a  c/r    was  struc<  without   any   previous 
entries. 

"2  Indicates  the  casse:  oarameter  base  was  not  eaual 

to  eight  or  ten. 


SEE  ALSO: 

retcharOf  aetf() 
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NAME: 


getsw  -  get  the  number  of  a  selected  logical  switch 


SYNOPSIS: 

g  e  t  s  w  (  )  ; 


DESCRIPTION: 

Determines  if  the  user  has  selected   a   valid   logical 

switch  on  the  Vector  General  tablet.  If  so/  it  returns 

the  number  of  that  switch. 


DIAGNOSTICS: 

Returned  -1  indicates  invalid  selection 


SEE  ALSO: 

buildswO;  s  i  x  p  a  k  (  )  ;  tabswO; 
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get  x  y 


NAME: 


getxy  -  aet  x,y  coordinates  of  a  ooint  on  the  tablet 


SYNOPSIS: 

getxy ( d ) 
int  o ; 
extern  float 


tx,tyJ 


DESCRIPT ION: 

Reads  (into  g  1  o  C  a  1  variables  tx  and  ty)  the  x,y  coor- 
dinate values  f  fo1"  the  tablet  at  the  ooint  defined  by 
the  tin  of  the  stylus.  If  the  parameter  'o'  is  a  1 » 
the  stylus  must  be  depressed  on  the  tablet  surface  to 
select  a  ooint;  if  'c'  is  a  0,  the  coordinates  nearest 
the  tio  of  the  oen  are  read.  These  coorainates  are 
automatically  converter!  to  virtual  tablet  coorainates 
if  the  tablet  has  been  red i rens i oneo  (by  a  crior  call 
to  t  aod  i  m) . 
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NAME: 


index  -  select  inaexinq 


SYNOPSIS: 

i  ndex ( i ,  x , y ) 
float  Xf  v  ? 
i  n  t  i  ; 


DESCSIP1  ION: 

If  i  equals  zerc/  indexing  is  deselected  ana  the 
dexino  flag  in  the  control  mode  is  turnea  off. 
inaex  reaisters  are  then  loaded  with  zero. 


1  n  - 
The 


If  i  enuals  oner  inaexino  is  selected  ana  the  indexing 
flag  in  the  control  "ooe  is  turned  on.  The  index  re- 
gisters are  then  loaded  with  the  oisolacements  oassed 
in  x  and  y.  x  is  loaded  in  the  x-index  (element)  re- 
gister and  y  is  loaded  in  the  /-index  (line)  register. 

x  must  oe  no  greater  than  the  user-defined  screen 
width.  y  must  be  no  greater  than  the  user-oefinea 
screen  height. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  oy  negative  returned   values. 
The  error  values  ana  their  meanings  are    as  follows: 

-1    Indicates  the  oassed  integer  i  is   not   equal   to 
zero  or  one. 

-2  Indicates  one  of  the  oassed  displacements  x  ana  y 

is  areater  than  the  screen  width  or  heiaht. 


SEE  ALSO: 

sc  reen  (  ) 
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NAME: 


inter  -  interactive  color  table  -nod  i  f  i  ca  t  i  on  routine 


SYMUPSIS: 

i  n  t  e  r  (  ) 


DESCRIPTION: 

Sets  ud  and  runs  a  tutorial  program  that  enaoles  the 
user  to  look  at/  select  and  modify  color  tacles  during 
program  execution.  T  n? r e  are  two  basic  mooes  in  which 
the  routine  ooerates.  Each  of  these  modes  has  a 
series  of  commands  wficn  the  user  can  execute. 

1.  Paqing  ;Vi  o  d  e  .  Upon  execution  trie  paging  ^oie  is 
immediately  enterea  and  a  set  of  instructions  is 
displayed.  The  following  commands  are  then  accept- 
ao  l  e  : 

d  -  Indicates  a  carticular  table  numher  is  to  be 
displayed.  The  number  must  then  be  entered 
between  zero  and  seventeen. 


n  - 


b  - 


i  - 


q  - 


Increments  table  number  displayed  toy  one 
Decrements  table  number  diSDlayed  by  one 
Disolays  instructions. 
Quits  from  the  interactive  routine. 


e  -  Enters  the  elit  mode. 

2.   Edit  '"':ooe.   '/.'hen  the  edit  mode  is  entered/   a  set 

of  instructions  is  displayed  listing  the  commands  that 

can  be  issued  and  the  edit  method  they  initiate.  The 
commands  are : 

t  -  Fnters  table  assignment  method.  Permits  en- 
tries fro^  any  taole  to  be  cocieo  into  the 
taole  designated  by  the  user.  The  taole 
nijmoer  wnich  is  to  receive  the  cooied  en- 
tries Tiust  oe  entered  first. 

o  -  Fnters  octal  assignment  method.  Entries  are 
specified  in  a  designated  table  by  entering 
the  ordered  triple  that  defines  the  color 
desired.  The  table  number  (  ^  -  1  7  )  in  which 
the  entries  are     to  oe  defined   must   be   en- 
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t  ered    first. 

c  -  Enters  combinina  assignment  method.  This 
methoc  allows  the  user  to  logically  OR  two 
seoarate  color  lockup  table  entries  into  a 
selected  user  table  entrv.  Whole  tables  may 
also  be  combined  into  a  selected  user  table. 
The  user  table  number  (4-17)  must  be  entered 
f  i  r  s  t  . 

f  -  Enters  inverting  tables  method.  This  method 
inverts  the  user  taole  designated  by  the 
user.  Entry  zero  oecomes  fifteen,  entry  one 
becomes  fourteen,  etc.  The  act  of  entering 
the  user  taole  numoer*  executes  the  inver- 
sion. 

m  -  Enters  cecving  taoles  method.  After  entry  of 
the  user  table  numOer  that  is  to  receive  a 
cooiec  table  the  number  of  the  table  to  be 
cooieo  is  entereo.  The  act  of  entering  the 
seconc  taole  number  causes  the  copy  to  take 
o 1  ace  . 


Upon  entry, 
St  ruct  i  ons 


the  editing  methoas  display  a  list  of  i  n  - 
on  how  the  metnod  is  to  be  used  and  the 
results  ontainec.  E  a  c  r,  of  the  metnoos  have  commands 
that  may  be  issued.  The  1  e  a  a  1  commands  for  eacn  eoit 
method  are    summarized  below. 


Table  Assignment  Method. 

n  -  Indicates  the  fable  number  ana  entry 
to  oe  cocied  follows. 

c / r- I n c r emen t s  througn   the  entries 
in  tKe  receiving  user  table. 

p  -  Displays  the  color  lookup  table  b  e  - 
modified.   To  return  from  the  dis- 
play, tyce  a  q. 

a  -  Quits  oack  to  edit  irooe  instructions 

Octal  Assignment  Method. 

n  -  Indicates  the  octal  triple  to  be  en- 
tered as  the  entry  follows. 

c/r-Increments  through  the  entries 
in  the  receiving  user  table. 

p  -  Disolavs  the  color  lookup  table  be- 
ing  modified.  To  return  from  the 
displav,  tvoe  a  q • 

a  -  Quits  back  to  edit  mode  instructions 


wa 


Combining  Assianment  Method. 

n  -  Indicates  the  two  oraered  pairs 

desiqnating  the  table  number  ana 
entry  number  to  be  0  P  d  are  to  fol- 
low. 

c/r-Increnopnts  through  the  entries  in 
the  receiving  user  table. 

o  -  Displays  the  color  Iookud  table 

Ceino  modified.   To  return  from 
the  display/  tyoe  a  q. 

w  -  Indicates  two  whole  tables  are  to 
be  combined  (OPd)  ana  their  n  u  m  - 
cers  are  to  follow. 

a  -  Quits  back  to  eait  mode  instructions 

Invert inc  Tables  Method. 

o  -  Displays  the  color  lookup  table  that 

is  bping  or  was  inverted. 
a  -  Quits  o  a  c  <  to  edit  mode  instructions 

Copyina  Tables  M  e  t  h  o  d  . 

o  -  Displays  the  receiving  table. 

a  -  Quits  back  to  edit  mode  instructions. 
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NAME: 


itoal  -  converts  integers  to  ASCII  for  outout 


SYNOPSIS: 

i  t  oa 1  ( i  n  )  ; 

int  in? 


DESCRIPTION: 

Itoal  ta^es  an  integer  value  ana  converts  it  to  an 
ASCII  coaed  character  string.  having  converted  the 
value  it  is  then  disDlayeo  at  the  user  oefined  COP. 


DIAGNGS I ICS: 

none 


SEE  ALSO: 

f toa (  )  ,     data  (  ) 
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Ittr 


NAME: 


lttr  -  aisolay  single  character 


SYNOPSIS: 

1  ttr(cfi,si  ze) 
i  n  t  ch/  size? 


DESCRIPTION: 

ia/HI  ctisolav  the  character  cassea  with  the  size  indi- 
cated at  trie  current  operating  point. 

After  display*  the  current  ooerating  point  is  on  tne 
same  line  any  seven  actual  screen  elements  to  the 
riqht  of  its  last  position. 

ch  contains  t^e  a  S  C 1 1  code  for  the  character  to  be 
displayed*  or  the  actual  character  enclosed  in  single 
auo t es  . 

If  size  is  equal  to  oner  the  character  is  displayed  in 
stan  lard  size. 

If  size  is  equal  to  t w o »  the  character  is  displayed  in 
-  j  o  u  o 1 e  width  size. 

The  operation  is  inoepenoent  of  any  mode  issuea  previ- 
ously* out  is  sensitive  to  the  flags  acplicable  to  Al- 
phanumeric moOe. 

Normal  return  is  zero. 


DIAGNOSI  ICS: 

Returnee  -1  indicates  the  cassed  integer  size  was   not 
equal  to  one  or  two. 


SEE  ALSu: 

stroutOf  o  a  t  a  (  )  /  sizeO/  inoexO,  bkrndO*  writonO 
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NAME.: 


out  -  outputs  ASCII  cnaracters  to  the  R A M T E K 


SYNOPSIS: 

out(ch); 


DESCRIPTION: 

Echos  the  nassec  ASCII  codeo  character  to  the  R  A  M  T  E  K 
screen.  T  n  e  C  G  P  is  then  incremented  to  the  right  to 
orevent  overwri tine. 


Typical  call: 
o  u  t  (  a  6  )  ; 


DIAGNOSTICS: 
none 


SEE  ALSU: 

dump  (  )  , 


1  t  t  r (  )  ,  retcnarC) 
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Dick 


NAME: 


Dick  -  output  an  integer  net  ween  zero  and  seventeen 


SYNOPSIS: 

o  i  c  k  (  i  )  ; 

int  i  ; 


DESCRIPTION: 

Outputs  an  integer  to  tne  R  A  M  T  E  K  screen  (between  0  and 
17)  deoendinq  entirely  uoon  tne  oasseo  carameter.  In- 
flexible out  useful  in  disclavs  involving  color   table 

^amoulat  ion. 


DIAGNOSTICS: 
none 


SEE  ALSO: 

dat  a (  ) 
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NAMfc: 


o  1  o  t  h  -  plot  data  as  a  histogram 


SYNOPSIS: 

p  1  O  t  h  (  x  ,  y  ,  n  ,  Pas*4  ) 

float  *  x  ,  *  v ,    base/* 
int  n ; 


DESCRIPTION1: 

The  values  y[i)  are  treated  as  functions  of  x[i],  &s 
the  function  is  plotted*  the  area  oetween  the  curve 
ana  the  x-axis,  as  designated  by  base,  is  filled  in 
with  the  color  last  selected. 

That  oortion  of  the  histogram  t  n  a  t  lies  on  the  screen 
will  ne  clotted. 

The  operation  is  totally  independent  of  any  control 
mode  issued  Dreviously. 

x  and  y  are  noirters  to  linear  arrays. 
n  is  the  number  of  points  to  be  plotted. 

Norrral  return  is  zero. 


DIAONOST ICS: 

All  errors  are     indicated  by  negative  returned   values. 
The  error  values  ana    their  meanings  are    as  follows: 

Peturnen  -1  indicates  the  oassed  parameter  base  is  not 
on  the  user-defined  screen. 


SEE  AlSu:  plotlnC)/  plotptC) 
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pi ot  1  n 


NAME: 


olotln  -  plot  data  with  connected  lines 


SYNOPSIS: 

plot  1 n ( x / y  #  n  ) 
■float  *x  0  *  v  J 
i  n  t  n  ; 


DESCRIPTION: 

T  n  e  values  vi.il  are  treated  as  functions  of  x  [  i  1  .  As 
the  function  is  dotted/  the  successive  points  are 
connected  hv  straight  lines  of  the  color  last  select- 
ee . 

Tnat  oortion  of  the  plotted  curve  w  h  i  c  H  lies  on  the 
screen  will  he  plotted. 

The  ooeration  is  totally  independent  of  any  control 
node  issued  oreviously. 

x  ana  v  are  oo inters  to  linear  arrays, 
n  is  the  nu^cer  of  points  to  be  plotted. 


SEE  ALSO: 

pi oth ( ) /  pi otpt ( ) 
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P 1 otpt 


NAMt : 


olotot  -  plot  data  w  "i  t  H  ooints 


SYNOPSIS: 

pi otpt ( x  t y / n J 

f 1  oat  *x  ,  +y  ; 

i  n  t  n  ; 


DE SCRIPT  ION: 

The  values  of  v  i  i  1  a  r  a  treated  as  functions  of  x  C  i  J  . 
The  function  is  plotter1  with  dots  'or  each  (.  x  (  i  j  »  y  [  i  ]  J 
coordinate.   Tne  aots  ire     in  t  n  e  color  last  selected. 

If  a  ooint  does  not  li  •  on  the  user- defined  screen/  it 
is  not  clotted. 

The  ooeration  is  totall/  inaeoendent  of  anv  control 
mode  issued  previously. 

x  and  y  are  oointers  to  linear  arrays. 
n  is  the  numoer  of  point;  to  be  plotted. 


SEE  AlSO: 

pi  oth  C )  «  plotlnO 


poi  nt 


lay  21  1977 


do  i  n  t 


NAMfc  : 


ooint  -  define  point 


SYNOPSIS: 

DO  i  nt  ( x , y  ) 
float  x  ,  y  ; 


DESCRIPTION: 

nefines  a  ooint  on  the  virtu*'  1  screen. 
He  within  the  usf  r-ief  i  neci  screen. 


The  ooint  must 


If  in  Graohic  vector  mode;  (<>v)  cef ines 
of  a  vector  and  causes  it  to  Oe  drawn 
operating  ooint  is  then  (  x  ,  y  )  . 


the   enapo  i  n  t 
The  current 


If 


i  n 


the  Graohic  .artesian  7i;ce>   (*,y)   defines   the 


diagonally  oooositf  corner  {fror  the  COP)  of  a  oro- 
cosed  rectanale.  Tne  rectangle  thus  defined  is  shaded 
in  the  currently  selected  color.  The  cuurent  ooerating 
point  is  tnen  (  x  ,  y  )  . 

If  in  the  Graohic  E Isrent  mode^  (x^y)  defines  a  single 

ooint   on   the  user-df  fined  screen  ana  causes  a  dot  to 

oe  drawn  t^ere.  The  ;urrent  op  .'  rating  ooint  is  then 
(  x  /  y  )  . 

i\'orm  al  return  is  zero. 


oiaomus r lcs : 

Returned  -1  indicates  t r e  oasseo  ooint  aces  not  lie  on 

the  user-aef inpc  screen. 


SEE  ALSO: 

St  r  t  x  y  (  ) 
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pointr 


NAMt : 


ooint  r  -  define  a  ooint  r-i1  at  i  v 


SYNOPSIS: 

do  intrfxf y) 
float  x ,  v ; 


DESCPIPI ION: 

Defines  a  ooint  on  tie  user-aeHned  screen  relative  to 
the  last  current  ooerat ing  ooint. 

If  in  G  r  a  d  h  i  c  Vector  mode  j  vector  f tot  the  last 
current  ooerat  i  na  ooint  to  a  ooint  definea  oy  the  last 
current  ooeratina  ooint  olus  Che  displacements  x  and  v 
is  drawn. 

If  in  tne  G  r  a  o  h  i  c  Cartesian  Tioce^  a  rectangle  is  de- 
fined ov  the  current  operating  ooint  and  the  point 
conputea  bv  adoinq  x  and  y  to  z'  e  COP.  This  rectangle 
is  d  i  so  1  a vea  in  the  c  rrent  cok  r. 

If  in  Graohic  Element  mode  a  dot  is  drawn  at  a  ooint 
defined  oy  tne  last  current  o  i'  rating  ooint  plus  the 
disolace^ents  x  and  v. 

The    COP  is  left  at  the  calculatec   location. 


SEE  ALSO: 

s  t  r t  xv (  ) 
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r am t  e k 
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ram t  ek 


NAMt : 


r  a  m  t  e  k  -  initiates  R  A  M  T  t  K  system 


SYNOPSIS: 

ram  t  e  k  (  ) 


DESCRIPI ION: 

Initiates  the  R  A  M  T  E  K  system  and  sets  the  default   con- 
ditions as  follows: 

1  -   Initialize  the  user-Jffined   screen   to   0.0   to 

100.0  in  x  ana  y. 

2  -   Loads  a  snades  of  grey  color  table   (0)   in   the 

R  A  M  T  E  K  • 

3  -   Selects  color  -fifteen  in  taole  zero  for  display. 

4  -   Selects  Alphanumeric  control  mode. 

5  -   Opens  the  R A  M T  E  K  for  r  }»ding  and  writing. 

6  -   Erases  the  screen. 

formal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1   inaicates   R A M T E  »   device   could   not   be 
opened. 
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red  i  m 
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red  i  m 


N  A  M  t : 


redim  -  re dimension  the  values  re«d  from  the  tablet 


SYNUPSIS: 

redi  m ( ) ; 
extern  float  tx/ty 


DESCRIPTION: 

Pe dimensions  or  converts  ' he  curre  it  x  ,  y  coordinates 
reaa  oy  "qetxv"  to  virtua1  tablet  coordinates.  This  is 
apol  icaole  after  the  routine  "tabai"  "  has  been  used  to 
redi^ension  the  virtu  el  tablet  to  a  user-defined  size. 
The  converted  coordinate  va'ues  are  Dlaced  in  qlooal 
variaoles  tx  and  tv.  No  parameters  are  passer)  either 
«iay  by  this  function. 


SEE  AL3U: 

qetxvO; 
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resc 1 r 
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resc  I  r 


NAMt: 


rescl r  -  restore  the  user's  color  tables  to  the  system 


SYNOPSIS: 

rescl r(  ) ; 
ciar  * s a v c o 1 t 

extern  colortblU  [  ]  ; 


0ESCR1P1  10  VJ : 

The  user's  version  of  trie  color  tables  are  brought 
into  the  s  v  s  t  e  m  from  a  user  Hie  c  il led  "savcol"  which 
must  have    been  created  by  a  orior  Cell  to  s  a  v  c  1  r  (  ). 

N ormal  return  is  the  number  of  bytes  re  an  from 
"savcol"  into  "colortbl  []  []"  (should  be  a48). 


DIAbMUS  f ICS : 

Returned  -1  indicates  an  unsuccessful  attempt  to   open 
the  file  "savcol". 

Returned   -2   indicates  an       error   ii   reading    from 
"savcol"  to  colortol  (J  []  . 


SEE  ALSO: 

save  1  r (  ) 
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rest  at 


NAMt: 


restat  -  restore  the  R A M T E K  (anr 
ous  status 


v G  Tablet)  to   previ- 


SYNOPSIS: 

restatC  ) ? 


DESCRIPI  I  UN: 

The  control  status  that  .«  a  s  in  effect  at  the  time  of 
the  last  call  tc  savstatC  )  is  restored  to  the  R A M T E K . 
This  includes  m  o  d  e  t  control  Hags,  color  table/  and 
the  di-nensions  of  the  virtual  s  jreen  ana  virtual  ta- 
blet. 


SEE  ALSU: 

savs t  a t  C 


186 
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retcnar 


NAME: 


retchar  -  read  a  character  f  r  o  ti  R A M T E K  Keyboard 


SYNOPSIS: 

retcharO 


DESCtflPT ION: 

An  ASCII  cods  reoresenting  the  typed  character  is   re' 
turned  ir  the  lower  half  of  an  integer. 


SEE  ALSU: 

oetnum(),  get H )/  qeti() 
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save  I  r 


NAME: 


savclr  -  save  the  current  color  tables 


SYNOPSIS: 

s  a  v  c  1  r  (  )  ; 
cnar  *savcoi; 
extern  colortbl  11  tl  ; 


DESlRIPl  ION: 

The  current  user-avail aole  color  taoles  C H  -  17)  are 
saver)  into  a  oe*)y-created  file  called  "saved"  in  the 
user's  directory.  Tnis  tile  ^ay  suoseauently  oe  re- 
opened and  read  back  into  the  s  v  s  t  e  m  by  a  call  to 
resclr(  ).  Tnis  al lows  the  user  to  preserve  desired 
color  scnemes  between  sessions. 

'Jor-pal  return  is  the  number  of  bytes  read  into 
"savcol"  -  -  (should  be  4  u  d ) . 


DIAGMOST  ICS: 

Returned   -1   indicates  an       unsuccessful   attempt   to 
create  the  file  "savcol". 

Returned  -2  indicates  an  error  in  writing  to   "savcol" 
from  colortbl  U  . 


SEE  ALSO: 

resc 1 r (  ) 
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sa v  s t  a t 


NAME: 


s  a  v  s  t  a  t  -  save  the  status  of  the  R  A  M  T  E  K  displav 


SYNOPSIS: 

savs t  a t  (  ) ? 


DESCRIPT ION: 

The  current  control  status  of  the  R  A  M  T  E  K  and  VECTOR 
GENERAL  Taolet  is  saved  for  subsequent  use.  This  data 
includes  Me  n  o  c  °  /  control  f laas/  current  color  table/ 
and  the  dimensions  of  the  virtual  screen  a  n  0  virtual 
tablet  . 


SEE  ALSO: 

rest  at  ( 
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sc  reen 


NAMfc : 


screen  -  define  user  screen 


SYNUP5I3: 

sc  reen ( x  1 ,  v  1 r  x2? y2) 
float  x  1  ,  yl/  x<2 ,  v2 ; 


D£SCR IP \ ION: 

Defines  a  standard  cartesian  coordinate  system  of  any 
scale  for  tne  user.  The  point  (xl,ylj  becomes  tne 
coordinate  of  tne  lower  1  e  *  t  corner  of  tne  screen. 
Tne  point  ( x 2 1 y 2 )  oecomes  the  coordinate  of  the  upper 
riaht  corner  of  the  screen. 


xl  must  Oe  strictly  less  than  x2. 

yl  must  be  strictly  less  than  v  2  . 

All  subsequent  user  coordinates  ar e 
coraing  to  this  user-aefined  screen. 


interpreted  ac- 


Normal  return  is  zero. 


DIAbNOS I  I C 5 : 

Returned  -1  indicates  xl  is  not  less  than  x  2  or  yl  is 
not  less  than  y  2  .  An  error  message  is  also  printed  on 
the  terminal  screen. 
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sc  ro  1  1 


NAMt  : 


scroll  -  scroll  screen 


SYNOPSIS: 

sc  ro 1  1  ( a  t cnt ) 
char  a  ? 
float  cnt; 


DESCRIPTION: 

Tne  current  displayed  oictore  on  the  screen  is 
scrolled  ud  or  a own.  Information  scrolled  off  the  too 
of  tne  screen  will  oe  scrolled  in  tne  bottom  ana 
vice-versa. 

If  a  is  the  character  ' a ' ,  the  direction  of  the  scroll 
will  oe  down. 

If  a  is  the  character  '  u '  t  the  direction  of  the  scroll 
will  oe  uc . 

cnt  is  the  number  of  user-defined  v-units  (lines)  that 
the  picture  is  to  oe  scrolled.  cnt  can  be  no  larger 
than  tne  virtual  screen  neiqht. 

N. 

Normal  return  is  zero. 


01  AGNUS  i  1 03: 

All  errors  are  indicated  bv  negative  returned   values. 
The  error  values  ana  their  meanings  are    as  follows: 

-1    Indicates  f  n  e  oassed  parameter  c  n  t  was  less   th^n 
zero  or  greater  tnan  the  screen  h  e  i  a  n  t  . 

-2    Indicates  the  passed  narameter  a  was  not  a  'd'  or 
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s  e  t  m  o  d  e 


Mav  21  lq77 


set  mode 


WAME: 


set  mode  -  select  control  mode 


SYNOPSIS: 

set  mode ( a / b ) 
int  a  r  d  / 


DESCRIPTION: 

Selects  the 
oa  ramet  ers 
f  o 1  lows: 


control   mode   according   to   tne   oassed 
a  and  r>.   a  reoresents  t^e  control  mode  as 


0  -  Alphanumeric 

1  -  Transverse  Data 

2  -  Raster  Data 

3  -  Como lex  Data 

4  -  Graohic  Vector 

5  -  Graphic  Plot 

o  -  Graphic  Cartesian 
7  -  Graoric  Element 

All  flags  are  turned  off  if  b  is  eaual  to  zero.  If  o 
is  equal  to  one/  ^nv  flags  set  in  tne  orevious  mode 
are  also  set  with  tne  mode  selected  ny  a.  All  enti- 
ties ddsolayed  suoseauent  to  this  call  are  disolayed 
according  to  the  selected  ^ode.  Routines  that  disre- 
gard the  selected  mode  ar^  axis(),  blockC)/  inter(), 
lttr(),  oloth(),  olotlnU,  olototO;  textoO,  and  vec- 
tor (  )  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are     indicated  by  negative  returned   values. 
The  error  values  and  their  meanings  are  as  follows: 

-1    Indicates  the  oassed  oarameter  a   was   less   t^an 
zero  or  greater  than  seven. 

-2  Indicates  the  oassed  oarameter  b  was  not  eaual  to 

zero  or  one. 


SEE  ALSO: 

ramtekC)/  b  k  r  n  o  (  )  /  d  n  1  w  i  d  (  )  >  fixotO/  indexO  , 
wri ton() 
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si  xpak 


NAME : 


sixoak  -  select  from  six  standard  switches  on  tablet 


SYNOPSIS: 

s  i  xoak ( ) } 


DESCRIPTION': 

Establishes  a  oacxage  of  six  selection  boxes  or 
switches  on  tne  Vector.  General  taolet  (accorainq  to 
Template  1)  a  n  rt  returns  the  numoer  of  the  switch 
selected  ov  tie  user  with  the  stylus. 


DIAGNOSTICS: 

Normal  return  is  the  number   of   the   Switch   selected 

Cl-6). 

Returned  -1  indicates  invalid  selection. 


SEE  ALSO: 

ouildswC);  q  e  t  s  w  C ) ;  tabsw(); 
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s  i  ze 


NAME: 


size  -  select  letter  size 


SYNOPSIS: 

si  ze  C  r) 

i  n  t  r  ; 


OESC^IPl ION: 

If  r  is  equal  to  one  the  standard   character   size   is 
usea . 

If  r  is  eaual  to  two  t  w  e  double  w i d 1  h   character   size 
is  used. 

Sets  the   douole   width   flag   in   the   control   mode. 
Therefore  size  takes  the  same  action  as  dblwid(l). 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  Dara meter   r   is   not 
equal  to  one  or  two. 


SEE  ALSO: 

dblwidO/  stroutO,  lttrC) 
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st  rout 


NAME: 


strout  -  output  character  string 


SYNOPSIS: 

s  t  rout ( so) 
Char  *so  ? 


DESCRIPTION: 

Outputs  a  character  string  no  greater  than  100  charac- 
ters long  beginnina  at-  the  current  ooerating  ooint  ani 
continuina  on  the  saie  line.  After  completion,  an  au- 
tomatic line  feel  occurs  which  defines  a  new  current 
operating  point  on  the  next-  line  at  the  sa^e  starting 
ooint  as  the  previous  line. 

so  ooints  to  the  character  string  to  be  output. 

'^lorrnal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  string  contained   -nore 
100   characters.    In   this  case  no  characters  wi 
d  i  sol  a  y  e  d . 


than 
1  be 


SEE  ALSu: 

d  a  t  a  ( )  /  sizeC),  lttrO,  textoO 
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s t  rt x  v 


NAMfc 


strtxy  -  establish  current  operating  point 


SYNOPSIS: 

st  rt  xy ( x  r y ) 
float  x ,  y ; 


DESCRIPTION: 

Establishes  the  current  ODerating  po;nt  on  the  screen 
for  suoseauent  instructions.  If  t'e  current  ^ode  is 
Graphic  Vector  with  the  fixed  point  flag  set  «  it  es- 
tablishes toe  case  from  which  the  vectors  are  drawn. 

x  is  a  user-defined  screen  locati>n  in  x. 
v  is  a  user-oefined  screen  1 ocat  i  :n  in  y. 

(x,y)  must  lie  within  the  user-defined  screen. 

Mortal   return  is  zero. 


DIAGNOSTICS: 

Returned  -!  inoicates  (  x  ,  y  )  does  not  lie  on  the   user' 
defined  screen. 


SEE  ALSO: 

fixpt(),  screenO,  oointO 
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symbo 1 


NAM£: 


symcol  -  disolay  a  soecial  svrbol 


SYNOPSIS: 

symbol  ( s  y  )  ; 
int  S y  C 6 1  ; 


DESCRIPTION: 

Ora^s  the  s  y  m  o  o  1  that  has  oeen  defined  by  tne  user. 
Thus  tne  user  may  aefine  special  symbols  to  augment 
tne  standard  A  C  S  1 1  character*  set.  R  e  a  u  i  r  e  s  the  pointer 
sy  to  the  user-defined  a^ray.  This  routine  automati- 
cally ou touts  12  ovtes  in  r  h  <=»  Transvirse  Data  mode. 


tyoical  data  declaration: 

int  a  1 d  n  a  ( ]   {0000000,0000042, 
0  052210,0 0520 42, 

oooooocooonooo}; 


t  yd i  c  a  1  call: 

tdata(aloha, 12,50.0,50.0); 


SEE  ALSO: 

t  dat a  C  ) 
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t  abco 1 o  r 


NAME: 


tabcolor  -  tablet  color  manipulation  function 


SYNOPSIS: 

t  aocc 1  or ( ) J 


DESCRIPTION: 

Allows   for   the   interactive   modification   of   color 
tables   via   the   VECTOR   GENERAL   TABLET.   The  system 

promots  for  required  incuts  f r  jr  the   tablet.   A   tem- 
plate for  the  tablet  is  reouir^o  for  input.  The  tablet 
fust  o  e  initialized  prior  to  ; filing  tabcolor  (see  t a - 
b  i  n  i  t  )  . 
Tyoical  c  3  1  1  : 

taoini  t  (); 

t  a  b  c  o  1  o  r  (  )  ; 


IS 

/fe 

11 

/a 

HA 

10 

// 

11 

IS 

n 

5 

4 

7 

8 

1 

0 

1 

2 

3 

4 

\ 

\ 

Template  Oe'c  riot  i  on 


DIAGNOSTICS: 


interactive  to  the  R  'i  ^1 T  E  K  a  k  access  terminal. 

SEE  ALSU: 

interC)  ,     savcolorO  /  resc'rO  ,  cnnged  ,     colorC)   t 
C  o 1 c  r  t  (  )  t      taDinitO 
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t  abdi  m 


NAME: 


taDdim  -  redimension  the  n  rtual  t  a  c  1  e  t 


SYNOPSIS: 

taDdim(xmax/  x^in^ynax,  vmir  ) 
d  o  u  o  1  e  xiiax^xmin,  v^ax/ vmif  ; 

i 
DESCRIPTION: 

A  c  c  e  o  t  s  as  na^Teters  a  t  a  x  i  m  u  ^  anf  ti  ni  tiuft  value  for 
the  <  and  y  dimensions  (in  that  (  rder)  and  'sets'  the 
tablet  to  tnpse  d  i Tensions.  A 1 1 o  H  the  user  to  view 
tne  virtual  tablet  in  any  size  i  attern  that  conforTs 
to  tne  standard  Cartesian   qrid   (  T i n i ru^   x,y   values 


reoresent  ed 


at 


lower   left   corner?  maximum  x  /  y 


values  located  at  the  uooer  right  corner). 
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t  ab  i  n  i  t 


NAME: 


t  a  b  i  n  i  t  -  ooen  the  t  a  o  1  e  t  for    the  user 


SYNOPSIS: 

t  a  b  i  n  i  t  (  )  ; 


DESCRIPT ION: 

Opens  the  Vector  General  t  a  b  I »  t  and  establishes  user 
access  via  file-rcinter  f  d  *  .  Sets  the  rr  a  x  i  rr  u  m  number 
of  loaicai  switches  available  to  2  S  .  Prints  an  error 
message  if  unable  to  ooen  t«*=  device. 
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tabsw 


NAME: 


tabsw  -  interactively  define  switches  on  the  tablet 


SYNOPSIS: 

t  absw ( sw ) 
i  n  t  s  w  ; 


DESCRIPTION: 

Allows  the  user  to  define  a  set  of  logical  switches  on 
the  taolet  bv  utilizing  the  styles  to  select  t  n  e  low 
set  of  coordinates/  the  i  the  high  set  of  coordinates 
( ie/  the  lower  left  corner  of  the  oesi  rea  selection 
bo  x  /  tnen  tne  ucoer  rigrt  corne'  of  the  box).  The 
numoer  of  switches  to  be  defined  is  indicated  by  the 
Dara^e^er  'sw1.  The  switches  are  numoered  seouent  i  al  1  y 
as  thev  are    defined. 

Prints  the  x/y  values  as  s  e  1  e  ;  t  e  d  /  alona  with  the 
switch  num ner  assignee  after  each  selection  d recess. 


SEE  ALSO: 

buildswO;  getsw();  sixoakC); 
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texto 


NAME  : 


texto  -  ni  solav 


block  of  t?; t 


SYNOPSIS: 

texto(txt,ctao*col  » s  z / w  o ) i 

int  ctaOfCol »sz»wo; 
Char  *t  x  t  I  1  (   }; 


DESCRIPTION: 

The  ^u 


t i p 1 e-en t r y  array  o 


ariable  lenath   character 


strings   addressed   Cy  *txt  is  displayed  on  the  RAMTEK 
accordina  to  t  n  e  other  parameters  : 


ctab  =>  desired  coloi  table  number 
col  =>  color  entrv  ^lom  that  table 
s  z  =>  desired  c  h  a  r  a  :  *  e  r  size  (1  or  2) 
wo  z>     1  if  a  d  a  i  t  i  v  e  "rite  is  desired*  0 


if  not 


formal  return  is  zero 


DIAGNOSTICS: 

Returned  -1  indicates  one  of  the  character  strings   is 
too  long  (over  10  0  characters). 

NOTE:  any  strings  over    9  \    characters   in   length   will 
"wrao  around"  the  screen  on  the  sa^e  line. 
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t b 1  who 


NAME: 


tDlwho  -  request  for  c  iprent  col'  r  table  number 


SYNOPSIS: 

t  b 1  who ( ) 


DESCRIPTION: 

Returns  an  inteaer  v-)'ue  which  is  the  table  number  of 
the  color  table  t  ~  a  t  is  c.rrently  being  used  for 
display. 
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tdata 


NAME: 


tdata  -  outDuts  transverse  -}/  t  a  for  the  user 


SYNOPSIS: 

tdata(trd,by,x,y) 

int  t  r d   [ ]  r 

int  by  '> 
float  x , v ; 


DESCRIPTION: 

The  v 


variable  t  re  is  the  n  *^e  of   a°   array   containing 
the   transverse   data 

~  u  m  o  e  r  of  bytes 
i  ng    oc i  n t  S 
transverse  data 


a   deHnition  for  the  image,  by  is 
to  De  passed  }        x   ,   y   are   the 
for    the    desired   cnsclay.   The 
is  oroces! en  b  v  t  e  by   oyte 
byte  heinq  cisolayec  d  i  r  e «  1 1 y  beneath  the 


the  numb 
start 


with   each 
as  t  one . 


tyoical  data  declaration: 

int  alohafl  {00000(0,000004?, 
00522  10,0052042, 
0000030,0000000}; 


tyoical  call: 

tdataCaloha, 12,50.'  ,50.0); 


The  function  will  not  o  » r  m  i  t  moving  off  of  the  screen 
as  it  dutcis  to  the  ri  iSr  one  ovte  ana  repositions  t  n  e 
user  selected  y  value  *n,l    continues. 


DIAGNOSTICS: 

none 


SEE  A  l  S  0  : 

set  mode (  )  ,  symbol  (  ) 
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terse 


NAM£: 


terse  -  selectively  erases  the  screen 


SYNOPSIS: 

terse(era,erb,erc*e.  rn)  ', 
float  e ra f e rb / e re / erd ; 


DESCRIPTION: 

Allows  the  user  to  selectively  erase  a  oortion  of   the 
screen   ov   cassina   the   coordinates   of  two  oocosite 

corners  of  a  box.  Tne  ar°a    within  the  defined  oox  will 

be  paintea  to  the  backaround  color. 


DIAGNOSTICS: 
none 


SEE  ALSO: 

strtxyO  ,    oointC)  /  set-nodeC)  ,  b  1  o  c  <  (  J 
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t  r  i  d  1  e 


NAME: 


triple  -  code  color  from  three-number  triple 


SYNOPSIS: 

triDleCtwqrr) 

i  nt  b  ,  q,  r  ', 


DESCRIPTION: 

The  three  input  parameters  represent  ire  the  intensi- 
ties of  b 1 u  e  C  b ) /  greenCq)  and  rei ( r )  are  cooed  into  an 
integer  which  is  suitable  for  insertion  into  a  color 
t  ao l e  entry. 

o  is  between  0  and  IS  and  represents  the  intensity  of 
D 1 ue  desirea. 

a  is  between  0  ana  IS  and  reoresents  the  intensity  of 
green  desired. 

r  is  between  0  and  IS  and  represents  the  intensity  of 
red  des  i  reel . 

Normal  return  is  an  integer  reoresentinq  the  cooe. 


DIAGNOSTICS: 

Returnea  -1  indicates  input  oarameters  b /  a  or   r  are 
neaative  or  greater  than  15. 


SEE  AlSO: 

ChngpC),  clrtblO 
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vector 


NAME: 


vector  -  araw    single  vector* 


SYNOPSIS: 

vectcrCxl /  y  1 »x2, y  2  ) 
float  x! /  yl/  x  2  /  y2  ; 


DESC3IPT ION: 

A  vector  is  drawn  en   the   screen   from   user-aefined 

screen   coordinate  (xl/yl)   to   (x2ry2).   The  current 

operating  ooint  is  left  at  Cx2/y2). 

The  operation  is  inaeoendent  of  any  m  o  a  e  i  ssuea  previ- 
ously but  is  sensitive  to  the  flaqs  applicable  to  the 
Graphic  Vector  cont-rol  mode.  Unoesi  red  results  may  be 
obtainea  if  the  fixot  f 1 ac  is  set  previous  to  calling 
vec  t or ( ) . 


Norma!  return  is  zero. 


DIAGNOSTICS: 

tfeturnea  -1  indicates  no  cortion  of  the  indicated  line 
lies  on  the  user  defined  screen. 


SEE  ALSO: 

bkrndC),  d  b 1 w  i  d  ()  /  f  i  x  p  t  C )  t     indexO 
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wri ton 


NAM£: 


writon  -  additive  write 


SYNOPSIS: 


wri  ton(w) 

i  n  t  w  ; 


DESCRIPTION: 

If  w  is  a  one*  the  additive  write  flag  in  the  control 
mode  is  turned  on  causing  subsequent  entities  in  Al- 
phanumeric* faster  Data  and  Transverse  Data  nodes  to 
write  on  too  of  orevious  entities  without  destroying 
them. 

If  w  is  a  ?erof  the  additive  write  flaa  in  t^e  control 
moae  is  turned  off. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  incicates  the  oassea  integer  w  is  neaative 

or    qreater  tn^n  one. 
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